Avançar para o conteúdo

BiRefNet V2 Background Removal

Integrar

ID do modelo birefnet/v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Este pedido: ≈0,002 $ 2 créditos da API Executar nesta página

Obter chave de API
BiRefNet Remoção do fundo #cutout#matting#open-weights

Remoção de fundos e recorte com abertura até 2304 px, com saída opcional da máscara.

BiRefNet · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório image_url
Largue um ficheiro ou

URL que identifica a imagem cujo fundo será removido.

Avançado operating_resolution · output_format · model · output_mask · refine_foreground · mask_only
operating_resolution predefinição 1024x1024

Resolução de trabalho, sendo '2304x2304' restrita ao modelo 'General Use (Dynamic)'. Para imagens de entrada de alta resolução, definições superiores melhoram a precisão da saída.

output_format predefinição png

Formato da imagem resultante.

predefinição General Use (Light)

Seleção do modelo de remoção do fundo: 'General Use (Light)' corresponde a BiRefNet, é o modelo original do repositório BiRefNet e é recomendado para a maioria dos casos. 'General Use (Light 2K)' corresponde a BiRefNet_lite-2K e utiliza esse modelo original treinado com imagens 2K. 'General Use (Heavy)' corresponde a BiRefNet_lite e oferece maior precisão com processamento mais lento. 'Matting' corresponde a BiRefNet-matting e foi treinado especificamente para recorte de imagens. 'Portrait' corresponde a BiRefNet-portrait e foi treinado especificamente com imagens de retrato. 'General Use (Dynamic)' corresponde a BiRefNet_dynamic e suporta resoluções variáveis de 256x256 a 2304x2304.

POST /run/birefnet/v2?wait=20 cotação → 0,002 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre BiRefNet V2 Background Removal

O BiRefNet V2 separa o objeto do fundo com várias variantes do modelo (light, heavy, matting, portrait, dynamic) e resoluções de operação até 2304x2304. Devolve o recorte e, opcionalmente, a máscara em PNG, WebP ou GIF.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
modelopcional
Tipoenum
PredefiniçãoGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Seleção do modelo de remoção do fundo: 'General Use (Light)' corresponde a BiRefNet, é o modelo original do repositório BiRefNet e é recomendado para a maioria dos casos. 'General Use (Light 2K)' corresponde a BiRefNet_lite-2K e utiliza esse modelo original treinado com imagens 2K. 'General Use (Heavy)' corresponde a BiRefNet_lite e oferece maior precisão com processamento mais lento. 'Matting' corresponde a BiRefNet-matting e foi treinado especificamente para recorte de imagens. 'Portrait' corresponde a BiRefNet-portrait e foi treinado especificamente com imagens de retrato. 'General Use (Dynamic)' corresponde a BiRefNet_dynamic e suporta resoluções variáveis de 256x256 a 2304x2304.
operating_resolutionopcional
Tipoenum
Predefinição1024x1024
1024x10242048x20482304x2304
Resolução de trabalho, sendo '2304x2304' restrita ao modelo 'General Use (Dynamic)'. Para imagens de entrada de alta resolução, definições superiores melhoram a precisão da saída.
output_maskopcional
Tipoboolean
Predefiniçãofalse
Controla se a máscara de remoção do fundo é incluída na saída.
refine_foregroundopcional
Tipoboolean
Predefiniçãotrue
Controla o refinamento do primeiro plano com base na máscara estimada.
image_urlobrigatório image
Tipourl · image
URL que identifica a imagem cujo fundo será removido.
output_formatopcional
Tipoenum
Predefiniçãopng
webppnggif
Formato da imagem resultante.
mask_onlyopcional
Tipoboolean
Predefiniçãofalse
Interruptor de saída apenas da máscara: `True` ignora o refinamento do primeiro plano e deixa a imagem intacta, devolvendo apenas a respetiva máscara de segmentação. Quando só é necessária uma máscara, evita cálculos adicionais e reduz os dados transferidos.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "mask_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
image
object {url, content_type, file_name, file_size, width, height}Imagem após a remoção do fundo ou a máscara de segmentação quando `mask_only` é `True`.
mask_image
object {url, content_type, file_name, file_size, width, height} | nullMáscara aplicada durante a remoção do fundo.

Mais modelos: Remoção do fundo

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/birefnet/v2.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt