2 créditos por chamada
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.
- REST · JSON
- Sem marca d'água
- Nada é armazenado
POST /v1/image-restoration
O que é a API de restauração de fotos?
A API de restauração de fotos da ImgGen AI é um endpoint REST que repara fotografias danificadas. Ela reduz riscos, rasgos, manchas, desbotamento e desfoque, e opcionalmente pode acrescentar cor a um original em preto e branco e aumentar sua resolução na mesma chamada. Você envia a digitalização e a imagem restaurada é devolvida na 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 Image Restoration.
Parâmetros da requisição
Envie uma requisição POST para https://app.imggen.ai/v1/image-restoration, autenticada com uma chave de API no cabeçalho Authorization.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| image | file | OBRIGATÓRIO | — | Acrescenta cor realista a uma fotografia em preto e branco enquanto a restaura. |
| colorize | boolean | opcional | false | Repara riscos, rasgos e danos físicos. |
| removeTears | boolean | opcional | false | Amplia a imagem restaurada para obter mais resolução. Acrescenta o custo do ampliador à chamada. |
| enhanceResolution | boolean | opcional | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
Como integro a API de restauração de fotos?
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/image-restoration' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form colorize=false \
--form removeTears=true \
--form enhanceResolution=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('colorize', 'false');
form.append('removeTears', 'true');
form.append('enhanceResolution', 'false');
const res = await fetch('https://app.imggen.ai/v1/image-restoration', {
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/image-restoration",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"colorize": "false", "removeTears": "true", "enhanceResolution": "false"},
)
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": "Image restored 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.
Três operações, uma chamada
Reparar, colorizar e ampliar são parâmetros da mesma requisição e não endpoints separados, então uma restauração completa é uma ida e volta em vez de três.
enhanceResolution custa mais
Ligar enhanceResolution acrescenta o custo do ampliador sobre a cobrança base de restauração, porque também roda o modelo de ampliação.
A qualidade da digitalização importa
O modelo reconstrói a partir do que consegue ver. Uma digitalização plana, com iluminação uniforme e na maior resolução que seu scanner permite dá resultados bem melhores que uma foto de celular de uma cópia impressa.
Para que serve a API de restauração de fotos?
Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.
Plataformas de genealogia e acervo
Ofereça restauração em um clique das fotografias de família que seus usuários enviam, sem construir nem hospedar um modelo de restauração.
Serviços de digitalização
Rode a restauração automaticamente conforme as digitalizações saem do scanner, para que os operadores revisem resultados em vez de editar cada imagem.
Acervos de museus e bibliotecas
Produza cópias de consulta apresentáveis de material fotográfico deteriorado mantendo os originais intocados.
Produtos de impressão fotográfica
Repare e amplie a fotografia enviada por um cliente em uma única chamada antes de ela ir para a impressão.
Quanto custa a API de restauração de fotos?
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 restauração de fotos costumam recorrer a estes em seguida.
Também disponíveis: Remoção de fundo, Remoção de marca d'água, Remoção de texto, Geração de imagens.
Perguntas frequentes sobre a API de restauração de fotos
- É um endpoint HTTP que repara fotografias danificadas automaticamente. Ele reduz riscos, rasgos, manchas, desbotamento e desfoque, e opcionalmente pode colorizar e ampliar o resultado. Existe para que um produto possa oferecer restauração aos seus usuários sem que ninguém faça retoque à mão.
- Sim. Defina colorize=true e o modelo acrescenta cor realista dentro da mesma passagem de restauração. Se cor é tudo de que você precisa e a fotografia não está danificada, o endpoint dedicado de colorização é a opção mais barata e direta.
- Dois créditos por chamada bem-sucedida. Definir enhanceResolution=true acrescenta o custo do ampliador por cima, porque roda um segundo modelo. O Starter inclui 400 créditos por mês por US$ 9,99 e o Pro inclui 1.400 por US$ 29,99, e os créditos não usados acumulam enquanto você continuar assinante.
- Riscos, rasgos, manchas, danos por água, perda de cor, amarelamento e falta de nitidez em geral. Defina removeTears=true especificamente para danos físicos. Áreas onde o conteúdo original desapareceu por completo são reconstruídas de forma plausível, não recuperadas — o modelo está inferindo, não desfazendo.
- Pode mudar, e vale entender isso antes de colocá-la diante dos seus usuários. O modelo reconstrói a informação que falta por inferência, então um rosto muito danificado ou de resolução muito baixa pode voltar sutilmente diferente da pessoa do original. Ele trabalha a partir do que é visível; onde nada é visível, produz um palpite plausível. Trate o resultado como uma interpretação restaurada, não como um original recuperado.
- Uma fotografia por requisição. Este endpoint não tem formato em lote — só a remoção de marca d'água aceita image[]. Para um acervo inteiro, dispare as requisições em paralelo a partir do seu próprio worker; cada uma é independente e cada uma é cobrada separadamente.
- 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.
Começar
Comece a chamar a API de restauração de fotos
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