2 créditos por chamada
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.
- REST · JSON
- Sem marca d'água
- Nada é armazenado
POST /v1/remove-watermark
O que é a API de remoção de marca d'água?
A API de remoção de marca d'água da ImgGen AI é um endpoint REST que localiza uma marca d'água em uma imagem e reconstrói o conteúdo que está embaixo dela. A detecção é automática, então nenhuma máscara é necessária, e o inpainting generativo preenche a área liberada para combinar com o entorno em vez de borrá-la. A imagem limpa é devolvida na mesma resposta.
É 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 Watermark Remover.
Parâmetros da requisição
Envie uma requisição POST para https://app.imggen.ai/v1/remove-watermark, autenticada com uma chave de API no cabeçalho Authorization.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| image | file | OBRIGATÓRIO | — | Formato em lote. Envie vários arquivos em image[] para processá-los em uma única requisição; a resposta devolve um array images mais failedImages com os que não puderam ser processados. |
| image[] | file[] | opcional | — | Batch form. Send multiple files under image[] to process them in one request; the response returns an images array plus failedImages for any that could not be processed. |
Como integro a API de remoção de marca d'água?
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-watermark' \
--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-watermark', {
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-watermark",
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": "Watermark 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.
Envios em lote
Este é o único endpoint da ImgGen que aceita lotes. Envie vários arquivos em image[] e a resposta trará um array images ao lado de failedImages listando tudo que não foi processado.
Detecção automática
Não há parâmetro de máscara, caixa ou pincel. O modelo localiza a marca d'água sozinho, então um único formato de requisição serve para imagens de origem muito diferentes.
Edite apenas o que é seu
Remover a marca d'água de uma imagem que não é sua ou que você não tem licença para editar pode violar direitos autorais. Use este endpoint nos seus próprios materiais ou em imagens que você tem o direito de modificar.
Para que serve a API de remoção de marca d'água?
Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.
Recuperar o seu próprio acervo
Remova a marca d'água antiga do seu estúdio de milhares de imagens próprias quando sua identidade de marca mudar, sem reprocessar os originais à mão.
Fluxos com material licenciado
Limpe os materiais com marca de prévia que você licenciou, como parte de um fluxo automatizado que publica no seu CMS.
Entrega fotográfica
Remova as marcas de prova das imagens depois que o cliente pagar, direto do seu sistema de pedidos.
Produção de templates
Limpe as marcas sobrepostas do material de origem que é seu antes de compô-lo em um template ou mockup.
Quanto custa a API de remoção de marca d'água?
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 de remoção de marca d'água 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 marca d'água
- É um endpoint HTTP que recebe uma imagem com marca d'água e devolve essa mesma imagem com a marca removida e a área atrás dela reconstruída. Como a detecção é automática, você não precisa dizer onde a marca está — e é justamente isso que a torna utilizável em um job em lote sem supervisão.
- Sim. A remoção de marca d'água é o único endpoint da ImgGen com suporte a lotes: envie seus arquivos em image[] em vez de image e a resposta devolverá um array images mais um array failedImages com o que não pôde ser processado. Todos os outros endpoints processam uma imagem por requisição.
- Dois créditos por imagem bem-sucedida, incluindo cada imagem de um lote. O Starter inclui 400 créditos por mês por US$ 9,99, o Pro inclui 1.400 por US$ 29,99, e os créditos não usados acumulam enquanto a assinatura estiver ativa.
- Você pode remover marcas d'água sem custo na ferramenta web da ImgGen usando seus 50 créditos iniciais, sem cartão. A API em si faz parte dos planos pagos Starter e Pro. APIs gratuitas de remoção de marca d'água em geral existem como testes ou demos com limites bem restritos, não como algo sobre o que construir um produto.
- Assistentes genéricos às vezes conseguem editar uma imagem, mas não foram feitos para isso: não detectam a marca de forma confiável, muitas vezes regeneram a imagem inteira em vez de reconstruir só a região afetada, e não há um formato de requisição estável para automatizar. Um endpoint de inpainting dedicado entrega saída consistente e um contrato sobre o qual você pode construir.
- Depende inteiramente de quem é o dono da imagem. Remover a marca d'água das suas próprias fotografias, ou de materiais que você licenciou com direito de edição, não é problema. Remover de uma obra protegida de outra pessoa para usá-la sem permissão é, e este endpoint não foi feito para isso.
- 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.
- Pela API não. A remoção de marca d'água em vídeo está disponível como ferramenta web em imggen.ai, mas não há endpoint de vídeo na API — todas as rotas /v1 processam imagens individuais.
Começar
Comece a chamar a API de remoção de marca d'água
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