Ir 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitação: ≈$ 0,002 2 créditos de API · ≈ ₽ 0,21 Executar nesta página

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

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

BiRefNet · Imagem

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório image_url
Solte um arquivo 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 padrão 1024x1024

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

output_format padrão png

Formato da imagem resultante.

padrão General Use (Light)

Seleção do modelo de remoção de fundo: 'General Use (Light)' corresponde a BiRefNet, é o modelo original do repositório BiRefNet e é recomendado para a maioria dos usos. 'General Use (Light 2K)' corresponde a BiRefNet_lite-2K e usa 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 aceita 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre BiRefNet V2 Background Removal

O BiRefNet V2 separa o objeto do plano de fundo com várias variantes do modelo (light, heavy, matting, portrait, dynamic) e resoluções de operação de até 2304x2304. Retorna 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 PadrãoPermitido Descrição
modelopcional
Tipoenum
PadrãoGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Seleção do modelo de remoção de fundo: 'General Use (Light)' corresponde a BiRefNet, é o modelo original do repositório BiRefNet e é recomendado para a maioria dos usos. 'General Use (Light 2K)' corresponde a BiRefNet_lite-2K e usa 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 aceita resoluções variáveis de 256x256 a 2304x2304.
operating_resolutionopcional
Tipoenum
Padrão1024x1024
1024x10242048x20482304x2304
Resolução de trabalho, sendo '2304x2304' restrita ao modelo 'General Use (Dynamic)'. Para imagens de entrada de alta resolução, configurações maiores melhoram a precisão da saída.
output_maskopcional
Tipoboolean
Padrãofalse
Controla se a máscara de remoção de fundo é incluída na saída.
refine_foregroundopcional
Tipoboolean
Padrã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
Padrãopng
webppnggif
Formato da imagem resultante.
mask_onlyopcional
Tipoboolean
Padrãofalse
Alternância de saída somente da máscara: `True` ignora o refinamento do primeiro plano e deixa a imagem inalterada, retornando apenas sua máscara de segmentação. Quando apenas a máscara é necessária, isso evita computação adicional e reduz os dados transferidos.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
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` for `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 de fundo

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