A API do remove.bg vai acabar. Mude uma linha, mantenha seu código.
O site independente e a API self-service do remove.bg acabam em . A API passa para a Leonardo.Ai (uma empresa da Canva), o que exige mudar sua integração (anúncio da Leonardo.Ai). O removebackground.dev aceita as mesmas requisições: aponte seu código para a nossa URL, use a nossa chave e pronto.
A API self-service do remove.bg acaba em
A única linha que muda
https://api.remove.bg/v1.0/removebghttps://removebackground.dev/v1.0/removebgO mesmo header X-Api-Key, com a sua chave do removebackground.dev. Os mesmos nomes de parâmetros, os mesmos headers de resposta, o mesmo formato de erro {"errors": [...]}.
Antes e depois
Uma integração típica em quatro linguagens. A chave vem de REMOVEBG_API_KEY, então a única mudança é a URL destacada.
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://api.remove.bg/v1.0/removebg
curl -f -H "X-Api-Key: $REMOVEBG_API_KEY" \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-o no-bg.png \
https://removebackground.dev/v1.0/removebg
Usa Zapier, Make ou n8n?
Abra a etapa de requisição HTTP que chama o remove.bg (Zapier Webhooks, Make HTTP, n8n HTTP Request), mude a URL para https://removebackground.dev/v1.0/removebg e o valor de X-Api-Key para a sua chave do removebackground.dev. Deixe todos os outros campos como estão.
Compatibilidade de parâmetros
Tudo o que sua requisição ao remove.bg envia é aceito. Algumas opções não têm efeito aqui, e isso está indicado abaixo.
| Parâmetro | Status | Observações |
|---|---|---|
image_file / image_file_b64 / image_url | Compatível | Corpos multipart, urlencoded ou JSON. JPG, PNG ou WebP de até 25 MB. |
size | Compatível | auto, full, 4k e 50MP dão a resolução original (até 25 MP); preview, small e regular ≈ 0,25 MP; medium 1,5 MP; hd 4 MP. Sempre 1 crédito. |
format | Compatível | auto (PNG se houver transparência, senão JPG), png, jpg, webp e zip (color.jpg + alpha.png). |
crop / crop_margin | Compatível | px ou % do objeto, de 1 a 4 valores no estilo CSS ("10% 20%" = vertical, horizontal); no máximo 500px ou 50% por lado. |
roi | Compatível | "x1 y1 x2 y2" em px ou %: só o objeto dentro da região é mantido. |
scale / position | Compatível | scale de 10% a 100% ou original; position center, original ou "x% y%". |
channels | Compatível | rgba (recorte) ou alpha (máscara em tons de cinza). |
bg_color | Compatível | Hex com ou sem # (81d4fa), ou o nome de uma cor. Um hex de 8 dígitos mantém a cor e descarta o alfa. |
bg_image_url / bg_image_file | Compatível | O recorte é sobreposto à sua imagem de fundo, ajustada em modo cover ao tamanho de saída. |
Accept: application/json | Compatível | Retorna { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } }. |
type / type_level | Aceito, ignorado | O objeto é detectado automaticamente; X-Type é sempre "other". |
semitransparency | Aceito, ignorado | Bordas suaves e áreas semitransparentes vêm da máscara do modelo do jeito que estão. |
shadow_type / shadow_opacity / add_shadow | Aceito, ignorado | Nenhuma sombra é adicionada. |
Requisições demoradas | Diferença | Esperamos até 110 segundos; se a imagem não estiver pronta até lá, você recebe um 503 que pode ser repetido (sem cobrança, a menos que tenha terminado). |
Headers de resposta
Uma chamada bem-sucedida responde com os bytes da imagem (image/png, image/jpeg, image/webp ou application/zip) e estes headers. Envie Accept: application/json para receber result_b64 no lugar.
| Header | Significado |
|---|---|
X-Width / X-Height | Tamanho do resultado em pixels. |
X-Credits-Charged | Créditos usados por esta imagem: sempre 1 (imagens com falha custam 0). |
X-Type | Sempre "other" (a detecção do objeto é automática). |
X-Foreground-Top / -Left / -Width / -Height | Caixa delimitadora do objeto no resultado, em pixels. |
X-Request-ID | Repete o seu X-Request-ID, ou um id gerado. Extra. |
X-Matte-Confidence / X-Matte-Ambiguous-Ratio | O quão limpa está a máscara (0–1) e a proporção de pixels suaves. Extra: útil para sinalizar imagens para revisão. |
Erros
| Status | Significado |
|---|---|
400 | Parâmetro ou imagem inválidos (códigos como invalid_size, invalid_crop_margin, missing_source, file_too_large, unknown_foreground). |
402 | insufficient_credits: recarregue na página de preços. |
403 | auth_failed: X-Api-Key ausente ou inválida. |
429 | rate_limit_exceeded. |
500 / 503 | O processamento falhou, excedeu o tempo limite ou o serviço está indisponível por um momento. Tente de novo; imagens com falha são grátis. |
Consulte seu saldo com GET https://removebackground.dev/v1.0/account: a resposta tem o formato de conta do remove.bg. Todos os detalhes na referência da API.
Créditos: 1 por imagem, e eles nunca expiram
Cada imagem processada com sucesso custa 1 crédito, seja qual for o tamanho ou as opções. Imagens com falha são grátis. Contas novas ganham 50 créditos grátis para testar.
- Créditos nunca expiramRecarregue uma vez e use na semana que vem ou no ano que vem.
- Sem assinaturaPacotes avulsos. Nada é renovado.
- Imagens com falha são grátisUm crédito só é usado quando o fundo é removido.
Checklist de migração
- Obtenha uma chave de API do removebackground.devCadastre-se (50 créditos grátis) e crie uma chave na página da sua conta.
- Mude uma linhaAponte seu código para https://removebackground.dev/v1.0/removebg e coloque a nova chave no mesmo header X-Api-Key.
- Teste uma imagemFaça uma requisição real e compare o resultado com o que você recebe hoje.
- Migre seu tráfegoFaça o deploy antes de 1 de dezembro de 2026 às 09:00 CET. Recarregue créditos uma vez; eles nunca expiram.
Perguntas frequentes sobre a migração do remove.bg
O remove.bg vai acabar?
O site independente e a API self-service do remove.bg acabam em 1 de dezembro de 2026 às 09:00 CET. A API passa para a Leonardo.Ai (uma empresa da Canva), o que exige mudar sua integração. Fonte: anúncio da Leonardo.Ai em https://www.leonardo.ai/news/removebg-api-leonardo.
Qual é o substituto mais simples para a API do remove.bg?
O removebackground.dev tem um endpoint compatível com o remove.bg. Troque https://api.remove.bg/v1.0/removebg por https://removebackground.dev/v1.0/removebg, envie uma chave do removebackground.dev no mesmo header X-Api-Key e mantenha o resto do seu código: os nomes de parâmetros, os headers de resposta e o formato de erro são os mesmos.
Preciso reescrever minha integração antes de dezembro de 2026?
Não. As requisições mantêm os mesmos parâmetros (image_file, image_url, size, format, crop, bg_color…) e recebem o mesmo tipo de resposta: os bytes da imagem com os headers X-Width, X-Height e X-Foreground-*, ou JSON com result_b64. Só a URL e a chave mudam.
Funciona com Zapier, Make ou n8n?
Sim. Na sua etapa de requisição HTTP (Zapier Webhooks, Make HTTP, n8n HTTP Request), mude a URL para https://removebackground.dev/v1.0/removebg e o valor de X-Api-Key para a sua chave do removebackground.dev. Nada mais muda.
Quanto custa?
1 crédito por imagem processada com sucesso, seja qual for o tamanho ou as opções. Sem assinatura: recargas únicas de US$ 17, US$ 49 ou US$ 99, e os créditos nunca expiram. Imagens com falha são grátis. Contas novas ganham 50 créditos grátis.
Quais parâmetros do remove.bg são compatíveis?
image_file, image_file_b64, image_url, size, format (auto, png, jpg, webp, zip), crop, crop_margin, roi, scale, position, channels, bg_color, bg_image_url e bg_image_file. type, type_level, semitransparency e as opções de sombra são aceitos e ignorados, então as requisições que os enviam continuam funcionando.
Posso consultar meu saldo como antes?
Sim. GET https://removebackground.dev/v1.0/account com a sua chave retorna seus créditos no formato de conta do remove.bg.
O removebackground.dev tem vínculo com o remove.bg?
Não. remove.bg é uma marca registrada do respectivo titular. O removebackground.dev é um serviço independente que aceita as mesmas requisições de API.
Troque antes de 1 de dezembro de 2026 às 09:00 CET
A API self-service do remove.bg acaba em
Crie uma chave, mude uma linha, teste uma imagem. 50 créditos grátis inclusos.
remove.bg é uma marca registrada do respectivo titular; o removebackground.dev não tem vínculo com ela.