Uma requisição HTTP familiar é só o começo. Use este checklist para testar imagens e integração antes de migrar a produção.
1. Confira as requisições que utiliza
Liste entrada, formato de saída, tamanho e parâmetros de edição. Há suporte a arquivo, URL HTTPS e base64 simples, mas não a todas as opções do remove.bg. Mantenha as chaves no servidor e crie uma nova em um plano com API.
2. Substitua o endpoint e a chave
Nas requisições compatíveis, mantenha a estrutura e troque a origem e X-API-Key. Se a biblioteca fixa o domínio remove.bg, use a opção de endpoint ou um cliente HTTP direto. Não envie uma chave do remove.bg para este serviço.
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. Confira os parâmetros antes de testar
Compatibilidade é a estrutura da requisição, não um recorte idêntico. type deve ser auto, type_level none e channels rgba. Parâmetros não suportados e não vazios são rejeitados, não ignorados.
| Campo da requisição | Suporte neste serviço |
|---|---|
| image_file / image_url / image_file_b64 | Escolha uma entrada: image_file, image_url ou image_file_b64. |
| format | auto, png, jpg ou webp. ZIP não é suportado. |
| size | Os limites de pixels variam por formato. Confira a tabela de tamanhos e os limites de saída. |
| crop / bg_color | Há suporte a crop=true/false e bg_color. |
| type / type_level / channels | Somente auto / none / rgba, respectivamente. |
| bg_image_url / shadow / roi / crop_margin / scale / position | Sem suporte a imagens de fundo, sombras, ROI, margens de recorte, escala ou posição. |
4. Confira as respostas e a cobrança
Confira Content-Type antes de salvar. O padrão são bytes de imagem, ou JSON com result_b64 quando solicitado. Verifique X-Credits-Charged e X-Request-ID. Chaves e créditos do remove.bg não são transferíveis. Aqui, prévia e resolução completa têm o mesmo custo por imagem.
5. Teste um conjunto representativo de imagens
Teste produtos, retratos, bordas de baixo contraste e todos os formatos, além de arquivos grandes, chaves inválidas, parâmetros não suportados e saldo insuficiente. Verifique 409, 429, timeouts e falhas. Guarde os IDs das requisições para investigar erros.
Idempotency-Key é opcional: reutilize a mesma chave, imagem e parâmetros para repetir um resultado bem-sucedido por 10 minutos sem nova cobrança. A repetição mantém X-Credits-Charged e adiciona X-Idempotent-Replayed: true. Requisições em andamento retornam 409. Chaves com falha ou expiradas ficam reservadas: use outra para uma nova requisição cobrada. Sem o cabeçalho, cada requisição é independente. Use timeout de 180 segundos.
6. Faça a troca gradual e mantenha uma opção de reversão
Direcione uma pequena parte da sua carga para a nova integração. Confira sucesso, qualidade e créditos antes de aumentar o tráfego. Mantenha a configuração anterior disponível. Roteamento e rollback são gerenciados pela sua aplicação, não por uma troca automática no serviço.
Este serviço é independente do remove.bg. Teste o comportamento, não apenas os nomes dos parâmetros.