1 crédito por chamada
API de remoção de fundo
Remova o fundo das suas imagens por código com uma única requisição POST. Uma chave de API, saída em PNG transparente e um serviço sem estado que nunca armazena as imagens que você envia.
- REST · JSON
- Sem marca d'água
- Nada é armazenado
POST /v1/remove-background
O que é a API de remoção de fundo?
A API de remoção de fundo da ImgGen AI é um endpoint REST que separa o objeto em primeiro plano do fundo de uma foto e devolve um PNG transparente. Você envia uma imagem por HTTPS, a IA detecta o objeto automaticamente e o recorte volta codificado em base64 dentro da resposta JSON. Nenhuma máscara ou seleção manual é necessária.
É um dos sete endpoints da API de edição de imagens da ImgGen AI, que compartilham uma única chave de API, uma única URL base e o mesmo formato de requisição e resposta. Se você também precisa desse recurso no navegador e não a partir de código, o mesmo modelo de IA move a ferramenta Background Remover.
Parâmetros da requisição
Envie uma requisição POST para https://app.imggen.ai/v1/remove-background, autenticada com uma chave de API no cabeçalho Authorization.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| image | file | OBRIGATÓRIO | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Como integro a API de remoção de fundo?
Crie uma chave de API na sua conta ImgGen, salve-a como variável de ambiente e chame o endpoint. Esta é a mesma requisição em cURL, Node.js e Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Resposta
Uma chamada bem-sucedida devolve JSON. O resultado vem codificado em base64 — decodifique antes de gravar em disco ou no seu armazenamento de objetos. Toda resposta bem-sucedida traz ainda um cabeçalho X-Credit-Remaining com seu saldo após a chamada.
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Limites e comportamentos que vale conhecer
O endpoint aceita JPEG (JPG), PNG e WebP com tamanho máximo de arquivo de 25 MB e responde de forma síncrona em até 60 segundos — não há job para consultar nem webhook para configurar.
Saída em PNG transparente
O resultado é devolvido com um canal alfa real, então você pode compor sobre qualquer fundo, cor ou template sem uma segunda requisição.
Sem máscara
A detecção do objeto é automática — o primeiro plano é separado do fundo para você. Não há nada para pintar, contornar ou passar como segundo parâmetro: envie a imagem de entrada e leia o resultado.
Nada é armazenado
A entrada fica em um objeto temporário durante a chamada e é apagada em seguida. Útil quando você processa fotos de clientes que não tem permissão para reter.
Para que serve a API de remoção de fundo?
Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.
Catálogos de e-commerce
Remova o fundo das imagens de produto dos seus fornecedores no envio para que cada anúncio mostre um recorte limpo e consistente sem nenhuma etapa de edição manual.
Marketplaces e classificados
Normalize automaticamente as fotos enviadas pelos vendedores. Passe cada envio pelo endpoint e guarde o PNG transparente junto do original.
Print-on-demand
Isole artes e objetos antes de compô-los sobre mockups, para que as prévias sejam renderizadas corretamente em qualquer tamanho de produto.
SaaS de design e edição
Ofereça aos seus usuários remoção de fundo em um clique dentro do seu próprio produto sem treinar um modelo, hospedá-lo ou rodar sua própria inferência na AWS ou em qualquer outro lugar.
Quanto custa a API de remoção de fundo?
Cada chamada bem-sucedida custa 1 crédito, então seu custo real por imagem depende do plano que você tem. Os créditos vêm do seu plano e são compartilhados entre todos os endpoints e o editor web, de modo que você não compra uma cota separada por ferramenta. Uma chamada que falha é reembolsada automaticamente. Veja todos os detalhes na página de preços.
| Plano | Preço | Créditos | API |
|---|---|---|---|
| Free | $0 | 50 créditos gratuitos únicos | Sem acesso à API |
| Starter | $9.99 / month | 400 créditos / mês | Acesso à API incluído |
| Pro | $29.99 / month | 1.400 créditos / mês | Acesso à API + suporte prioritário |
| Enterprise | Custom | Volume personalizado | Infraestrutura dedicada |
Custos em créditos e limites verificados pela última vez em 2026-08-27.
Endpoints e ferramentas relacionados
As equipes que usam a API de remoção de fundo costumam recorrer a estes em seguida.
Também disponíveis: Ampliação de imagens, Restauração de fotos, Colorização de fotos, Geração de imagens.
Perguntas frequentes sobre a API de remoção de fundo
- É um endpoint HTTP que recebe uma foto e devolve essa mesma foto com o fundo removido e o objeto preservado sobre uma camada transparente. Por ser uma API e não um editor, você pode chamá-la a partir de um job de backend, de um worker de fila ou do handler de upload dos seus usuários e processar milhares de imagens sem que ninguém abra um navegador.
- Crie uma chave de API na sua conta ImgGen e envie por POST um formulário multipart com um campo image para https://app.imggen.ai/v1/remove-background com um cabeçalho Authorization: Bearer. A resposta é JSON; decodifique o campo image em base64 e grave em disco ou no seu armazenamento de objetos. Há exemplos funcionais em cURL, Node.js e Python nesta página.
- Um crédito por chamada bem-sucedida — o endpoint mais barato da API. O Starter inclui 400 créditos por mês por US$ 9,99, ou seja, cerca de 400 remoções de fundo, e o Pro inclui 1.400 por US$ 29,99. Os créditos não usados acumulam enquanto a assinatura estiver ativa, e chamadas que falham são reembolsadas automaticamente, então você só é cobrado pelas imagens que voltam.
- Você pode criar uma conta e testar as ferramentas de IA com 50 créditos gratuitos e sem cartão. O acesso à API faz parte dos planos pagos Starter e Pro; não existe um nível de API gratuito permanente, e preferimos dizer isso a anunciar um que depois limite a velocidade em silêncio.
- A API aceita arquivos JPEG (JPG), PNG e WebP de até 25 MB por imagem. Os resultados são devolvidos como imagem codificada em base64 dentro da resposta JSON.
- Não. A API não guarda estado: ela não cria projeto, não salva arquivo nem mantém sua imagem. Seu envio é gravado em um objeto temporário, processado e apagado assim que a resposta é devolvida. A única coisa mantida é um registro de uso anotando que houve uma chamada e quantos créditos ela custou. Suas imagens nunca são usadas para treinar modelos.
- Sim. Todos os planos, inclusive o gratuito, incluem direitos de uso comercial completos, e nenhum resultado leva marca d'água. Você pode vender, imprimir ou publicar qualquer coisa que a API devolver.
- O endpoint devolve um PNG transparente, então compor uma nova cor, gradiente ou cenário é algo que você faz no seu próprio fluxo — sem uma segunda chamada à API. O editor web da ImgGen também tem um gerador de fundos, caso você queira fundos gerados por IA em vez dos seus próprios materiais.
Começar
Comece a chamar a API de remoção de fundo
Uma única chave libera os sete endpoints. Sem marca d'água, com direitos comerciais completos e sem que nada do que você envia seja armazenado depois que a resposta é devolvida.
Obtenha sua chave de API