Introdução
Background Remover separa o assunto principal de uma foto de tudo o que está atrás dele e o devolve sobre um fundo totalmente transparente. Você envia uma URL de imagem e recebe um PNG com canal alfa, com a mesma largura e altura do original, de modo que o recorte se alinha pixel a pixel com a fonte sempre que você precisar combinar os dois.
Não há prompt, nem máscara, nem ajuste: a ferramenta decide sozinha o que é primeiro plano.
Recursos e destaques
Transparência pronta para qualquer layout
Os pixels do fundo não são pintados de branco, e sim deixados totalmente transparentes, então o resultado se encaixa sobre qualquer cor, degradê ou foto sem uma caixa em volta. É esse o formato que marketplaces, apresentações, ferramentas de design e páginas web esperam para recortes de produtos e retratos.
Nada para escrever, nada para ajustar
A requisição inteira é uma única URL de imagem. Como nada é redigido, não existe palavra mal escolhida nem segunda tentativa causada por uma instrução ambígua, o que facilita processar uma pasta inteira de fotos de catálogo num loop.
Dimensões originais preservadas
O recorte volta no tamanho da imagem enviada, e não num quadrado fixo, então você pode colocá-lo de volta sobre a fonte, usá-lo como máscara ou passá-lo para a próxima etapa de edição sem redimensionar.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto a recortar, em JPEG, PNG ou WebP. O assunto é detectado automaticamente, então corte antes se o quadro tiver vários candidatos. pelo menos 1 caracteres |
Preços
$0.0048 / imagem
Cobrado por imagem gerada; o tamanho da foto que você envia não muda o preço.
Casos de uso
Catálogo de produtos e anúncios em marketplaces
Fotografe os produtos na superfície que estiver à mão, remova o fundo depois e coloque cada item sobre a mesma cor limpa. Um fundo padronizado em todos os anúncios é a melhoria visual mais rápida para uma loja, e já não exige montar um fundo de estúdio para cada item.
Avatares, páginas de equipe e miniaturas
Isole pessoas de paredes de escritório, salas ou cenas de rua para criar fotos de perfil, cartões de palestrantes e miniaturas de vídeo com um fundo da marca atrás.
Primeiro passo de uma edição mais longa
Recorte o assunto antes de uma composição: remova o fundo aqui, crie uma cena nova com Image Expander e depois coloque o PNG transparente por cima.
Guia de prompt e dicas práticas
Escolha fotos com um assunto claro
A ferramenta escolhe o primeiro plano sozinha. Ela é mais confiável quando uma pessoa ou um objeto domina claramente o quadro e se destaca do fundo pela cor ou pela luz. Se uma imagem mostra várias pessoas ou objetos com o mesmo peso, corte para o que você quer antes de enviar, porque a ferramenta pode manter mais do que você pretendia.
Confira as bordas finas em tamanho real
Cabelo, pelo, renda, fumaça e vidro são as áreas mais difíceis de um recorte. Examine-as com zoom antes de publicar, principalmente quando o fundo tem cores parecidas com as do assunto. Refazer a foto com um fundo mais simples resolve mais do que processar de novo a mesma imagem.
Mantenha o arquivo em PNG
A transparência só sobrevive em formatos que a suportam. Salve e repasse o resultado em PNG; convertê-lo para JPEG preenche a área transparente com uma cor sólida e traz de volta o retângulo que você acabou de remover.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/background-remover-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
