2 créditos por chamada
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.
- REST · JSON
- Sem marca d'água
- Nada é armazenado
POST /v1/remove-text
O que é a API de remoção de texto?
A API de remoção de texto da ImgGen AI é um endpoint REST que localiza o texto de uma imagem e o remove, reconstruindo o fundo onde estavam os caracteres. Ela lida com legendas, sobreposições, carimbos de data e etiquetas incrustadas sem máscara. Se o modelo não encontrar texto, a requisição devolve 422 e nenhum crédito é debitado.
É 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 Image Text Remover.
Parâmetros da requisição
Envie uma requisição POST para https://app.imggen.ai/v1/remove-text, autenticada com uma chave de API no cabeçalho Authorization.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| image | file | OBRIGATÓRIO | — | The image to clean. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
Como integro a API para remover texto de imagens?
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-text' \
--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-text', {
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-text",
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": "Text 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.
Sem texto, sem cobrança
Se o modelo não detectar texto na imagem, o endpoint devolve 422 VALIDATION_ERROR e não debita nada. Você pode apontá-lo para um conjunto misto de imagens sem pagar pelas que já estão limpas.
Preenchimento generativo, não desfoque
A área atrás dos caracteres é reconstruída para combinar com o entorno em vez de borrada, então o resultado se sustenta em fundos cheios de detalhe.
Detecção automática
Não há parâmetro de região ou de caixa delimitadora — o modelo encontra o texto sozinho, e é isso que torna o endpoint seguro para rodar sem supervisão.
Para que serve a API para remover texto de imagens?
Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.
Fluxos de localização
Remova o texto incrustado no idioma original das suas imagens de marketing para que uma versão localizada possa ser composta para cada mercado.
Higiene de anúncios em marketplaces
Remova sobreposições promocionais e marcas de concorrentes que os vendedores acrescentam às fotos de produto, aplicando as regras do catálogo automaticamente.
Limpeza de acervos
Apague carimbos de data e etiquetas de câmera incrustados em fotografias digitalizadas ou antigas antes que entrem em uma biblioteca de mídia.
Reaproveitamento de templates
Recupere uma imagem base limpa a partir de uma peça finalizada para que a mesma arte possa levar um texto novo.
Quanto custa a API para remover texto de imagens?
Cada chamada bem-sucedida custa 2 créditos, 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 para remover texto de imagens 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 texto
- É um endpoint HTTP que detecta os caracteres escritos em uma foto e os apaga, preenchendo o fundo que estava escondido atrás deles. É o equivalente programático a clonar o texto à mão em um editor, só que roda em um segundo e não precisa de ninguém para marcar a região.
- A requisição devolve HTTP 422 com o código VALIDATION_ERROR e nenhum crédito é cobrado. Isso torna seguro rodar o endpoint de forma preventiva em um lote misto — você só paga pelas imagens que de fato tinham texto a remover.
- É exatamente o que este endpoint faz. Em vez de pintar por cima dos caracteres, ele detecta a região de texto, remove-a e reconstrói o fundo que estava escondido usando os pixels ao redor como referência. Tudo fora da região de texto fica intacto, então o resto da foto é idêntico ao que você enviou.
- Sim. A detecção cobre a imagem inteira, então cada região de texto que ele encontrar — uma legenda, um carimbo de data num canto e uma etiqueta no meio — é removida na mesma chamada. Note que agrupar várias *imagens* em uma requisição não é suportado aqui; envie uma imagem por requisição, ou use o endpoint de marca d'água se precisar de envios em lote.
- Fora da região de texto, não — esses pixels passam sem alteração. Dentro dela o conteúdo é gerado em vez de recuperado, então um fundo carregado ou muito detalhado é uma reconstrução mais difícil que um fundo liso. A resolução de saída acompanha a de entrada; nada é reduzido.
- Para isso use o endpoint dedicado de remoção de marca d'água. Ele é ajustado para as sobreposições semitransparentes, repetidas ou em mosaico típicas de marcas d'água, e é o único endpoint que aceita envios em lote. Este aqui mira texto opaco: legendas, carimbos de data e etiquetas incrustadas.
- Dois créditos por chamada bem-sucedida, e nada quando nenhum texto é detectado. O Starter inclui 400 créditos por mês por US$ 9,99 e o Pro inclui 1.400 por US$ 29,99, com os créditos não usados acumulando enquanto a assinatura estiver ativa.
- Não — a detecção é automática e vale para a imagem inteira. Não há parâmetro de região nem de caixa delimitadora. Se precisar de remoção seletiva, o editor web da ImgGen tem um removedor de objetos com pincel para esse tipo de trabalho guiado à mão.
- 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.
Começar
Comece a chamar a API de remoção de texto
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