v1 · 7 endpoints · no ar
Edição de imagens
API para desenvolvedores
Sete endpoints de processamento de imagens com IA atrás de uma única chave de API: remoção de fundo, ampliação, remoção de marca d'água e de texto, restauração, colorização e texto para imagem. REST puro, uma resposta JSON e nada armazenado depois que a chamada termina.
- 7 endpoints, 1 chave
- REST sobre HTTPS
- Sem marca d'água
- Nada é armazenado
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}O que é a API de edição de imagens da ImgGen AI?
A API de edição de imagens da ImgGen AI é um serviço REST que faz processamento de imagens com IA sob demanda. Você envia uma imagem — ou um prompt de texto — para um endpoint via HTTPS e o resultado processado volta codificado em base64 dentro da resposta JSON. Não há modelo para hospedar nem GPU para provisionar.
Todos os endpoints compartilham a mesma URL base, a mesma chave de API e o mesmo formato de resposta, então acrescentar um segundo recurso ao seu fluxo é trocar de caminho, não montar uma integração nova. Se quiser testar os modelos antes de escrever código, esses mesmos modelos movem as ferramentas gratuitas da ImgGen AI no navegador.
Como se usa a API de edição de imagens?
Gere uma chave de API e envie uma requisição multipart com a sua imagem. Este exemplo remove um fundo; todos os outros endpoints de edição seguem o mesmo padrão com um caminho diferente. A geração de imagens é a única exceção — ela recebe um corpo JSON com seu prompt, o número de amostras e a proporção em vez de um arquivo.
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 { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(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},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))Os sete endpoints
Cada um tem sua própria página de referência com parâmetros, exemplos de código em três linguagens e seu custo exato em créditos.
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.
API de ampliação de imagens
Aumente a resolução das suas imagens em 2x ou 4x a partir do seu próprio backend. Melhoria facial e nitidez opcionais, saída em JPEG ou PNG e um preço que acompanha o fator que você pedir.
API de remoção de marca d'água
Detecte e apague marcas d'água das suas imagens em uma única requisição. O inpainting generativo reconstrói os pixels que estavam atrás da marca, e este é o único endpoint que também aceita um lote de imagens.
API de remoção de texto
Apague legendas, sobreposições, carimbos de data e etiquetas incrustadas nas suas imagens por código. A detecção é automática — e se a imagem não tiver texto, você não é cobrado.
API de restauração de fotos
Repare fotografias antigas, danificadas e desbotadas a partir do seu próprio backend. Opcionalmente colorize e aumente a resolução na mesma requisição, em vez de encadear três chamadas.
API de colorização de fotos
Transforme fotografias em preto e branco em imagens com cor natural em uma única requisição. Reparo de rasgos opcional na mesma chamada e sem escolher cores à mão em momento algum.
API de geração de imagens com IA
Gere imagens a partir de um prompt de texto com uma única requisição JSON. Até quatro amostras por chamada, três modelos para equilibrar velocidade e qualidade, e direitos comerciais completos sobre o resultado.
Quanto custa a API de edição de imagens?
O uso é baseado em créditos e não em uma taxa fixa por chamada, então um mês intenso e um mês tranquilo custam o mesmo por imagem. Os créditos são compartilhados entre todos os endpoints e o editor web — um só saldo, não uma cota separada por ferramenta. Uma chamada que falha é reembolsada automaticamente, e toda resposta bem-sucedida devolve seu saldo restante no cabeçalho X-Credit-Remaining.
| Endpoint | Caminho | Créditos / chamada |
|---|---|---|
| Remoção de fundo | /v1/remove-background | 1 |
| Ampliação de imagens | /v1/upscale-image | 2–4 |
| Remoção de marca d'água | /v1/remove-watermark | 2 |
| Remoção de texto | /v1/remove-text | 2 |
| Restauração de fotos | /v1/image-restoration | 2 |
| Colorização de fotos | /v1/colorize-photo | 2 |
| Geração de imagens | /v1/generate-image | 3+ |
| Plano | Preço | Créditos | API | Observações |
|---|---|---|---|---|
| Free | $0 | 50 créditos gratuitos únicos | Sem acesso à API | Não pede cartão de crédito |
| Starter | $9.99 / month | 400 créditos / mês | Acesso à API incluído | Créditos não usados acumulam |
| Pro | $29.99 / month | 1.400 créditos / mês | Acesso à API + suporte prioritário | Créditos não usados acumulam |
| Enterprise | Custom | Volume personalizado | Infraestrutura dedicada | support@imggen.ai |
Custos em créditos e limites verificados pela última vez em 2026-08-27. Todos os detalhes na página de preços.
Como a API funciona
Deliberadamente sem graça: uma requisição, uma resposta e nenhuma orquestração do seu lado.
Síncrona, sem filas
A imagem processada vem no corpo da mesma resposta. Nenhum ID de job para consultar, nenhum endpoint de webhook para subir, nenhuma fila para reconciliar. As requisições têm um limite de 60 segundos.
Multipart na entrada, base64 na saída
Envie sua imagem de entrada como formulário multipart — JPEG (JPG), PNG e WebP, até 25 MB. O resultado volta codificado em base64 no corpo JSON: decodifique e grave onde você guarda seus arquivos.
Só cobra quando dá certo
Os créditos são debitados de forma atômica e reembolsados automaticamente se o processamento falhar, então você só é cobrado pelas imagens que realmente voltam. A remoção de texto chega a devolver 422 sem custo algum quando não há texto para remover.
Chaves que você pode rotacionar
As chaves são exibidas uma única vez e guardadas apenas como hash. A revogação se propaga em cerca de um minuto, então uma chave vazada é um problema de um minuto, não um incidente.
A API armazena minhas imagens ou treina com elas?
Não. A API não guarda estado. Diferente do editor web, que salva seus projetos para você voltar a eles depois, uma chamada de API não cria projeto, registro de tarefa nem arquivo armazenado. 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. Isso importa se você processa fotos de clientes que contratualmente não pode reter — é a arquitetura, e não apenas a política, que as mantém fora do nosso armazenamento.
Respostas de erro
As falhas devolvem um envelope JSON no formato { "error": { "message", "code" } }, com o status HTTP correspondendo ao código.
| Status | Código | Significado |
|---|---|---|
| 401 | UNAUTHORIZED | A chave de API está ausente, malformada ou foi revogada. |
| 402 | INSUFFICIENT_CREDITS | Sua conta não tem créditos suficientes para esta chamada. |
| 403 | FORBIDDEN | Seu plano não dá acesso a esta ferramenta. |
| 404 | NOT_FOUND | O caminho do endpoint não existe. |
| 409 | CONFLICT | A requisição conflita com o estado atual do recurso. |
| 422 | VALIDATION_ERROR | A requisição foi rejeitada: tipo de arquivo inválido, campo ausente ou nada a processar. Nenhum crédito é cobrado. |
Quem usa a API da ImgGen?
Onde uma API de processamento de imagens conquista seu lugar dentro de um produto.
E-commerce e marketplaces
Normalize as imagens de fornecedores e vendedores no envio — recorte fundos, remova textos sobrepostos e amplie fotos antigas de baixa resolução para que todos os anúncios pareçam ter saído do mesmo estúdio.
Print-on-demand e mockups de produto
Isole a arte, aumente a resolução até o padrão de impressão e componha sobre templates sem que um designer precise tocar em cada pedido.
SaaS de design e edição
Lance recursos de edição em um clique dentro do seu próprio produto sem hospedar GPUs, ajustar modelos ou manter uma infraestrutura de inferência.
Arquivos, genealogia e digitalização
Repare, colorize e amplie fotografias digitalizadas em um fluxo automatizado em vez de retocar cada imagem à mão.
Plataformas de conteúdo e publicação
Gere imagens originais a partir de um prompt e limpe os envios dos colaboradores como parte do seu fluxo editorial atual.
Agências e ferramentas internas
Automatize o trabalho repetitivo com imagens que fica entre o briefing do cliente e o material final, a partir das ferramentas que sua equipe já usa.
Perguntas frequentes sobre a API de edição de imagens
- Sim. A API de edição de imagens da ImgGen AI expõe sete endpoints REST — remoção de fundo, ampliação de imagens, remoção de marca d'água, remoção de texto, restauração de fotos, colorização e geração de imagens a partir de texto — todos em https://app.imggen.ai e acessíveis com uma única chave de API.
- Ela executa uma edição específica na imagem que você envia e devolve o resultado na mesma resposta. Você pode remover um fundo e obter um PNG transparente, ampliar em 2x ou 4x, apagar marcas d'água ou textos incrustados, reparar e colorizar fotografias danificadas e gerar imagens novas a partir de um prompt de texto.
- Crie uma conta ImgGen em https://editor.imggen.ai e gere uma chave nas configurações da sua conta. A chave é exibida uma única vez e guardada apenas como hash, então copie-a para um lugar seguro: se ela se perder, você gera uma nova em vez de recuperar a antiga. Revogar uma chave passa a valer em cerca de um minuto.
- Envie sua chave como bearer token: Authorization: Bearer sk_live_… em toda requisição. Chaves emitidas antes do esquema atual também podem autenticar com o cabeçalho legado x-imggen-key, que continua sendo aceito.
- O uso é medido em créditos, e não em uma taxa fixa por chamada, e o custo depende do endpoint: remoção de fundo custa 1 crédito; remoção de marca d'água, remoção de texto, restauração e colorização custam 2; a ampliação custa 2 com factor=2 e 4 com factor=4; a geração de imagens começa em 3 e varia conforme o modelo. O Starter dá 400 créditos por mês por US$ 9,99 e o Pro dá 1.400 por US$ 29,99, com os créditos não usados acumulando enquanto a assinatura estiver ativa.
- Uma conta ImgGen gratuita vem com 50 créditos e não pede cartão, o que basta para avaliar os modelos nas ferramentas web. 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 claramente 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.
- Síncronos. Não há ID de job para consultar, fila para gerenciar nem webhook para configurar — a imagem processada vem no corpo da mesma resposta. As requisições têm um limite de 60 segundos.
- 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 de remoção de marca d'água aceita um lote de arquivos em image[] e devolve um array images. Todos os outros endpoints processam uma imagem por requisição — para volume, dispare as requisições em paralelo a partir do seu próprio worker, já que cada chamada é independente.
- No momento não. A API é REST puro sobre HTTPS com envios multipart, então qualquer cliente HTTP serve, e a documentação traz exemplos prontos para copiar em cURL, Node.js e Python. Ainda não há biblioteca cliente oficial nem especificação OpenAPI publicada.
Começar
Faça sua primeira chamada em cinco minutos
Crie uma chave, copie o exemplo em cURL e você já tem a remoção de fundo funcionando. Uma só chave cobre os sete endpoints, em todos os planos que incluem acesso à API.
Obtenha sua chave de API