O que é uma API de ampliação de imagens e como ela funciona?

É um endpoint HTTP que aumenta a resolução de uma imagem usando um modelo treinado. Em vez de interpolar entre os pixels existentes, como faz um redimensionamento, o modelo prevê o detalhe que uma versão de maior resolução daquela imagem teria — bordas, textura e estrutura — e o reconstrói. Você envia a imagem por POST e lê o resultado ampliado na resposta.

Quais fatores de ampliação e tipos de imagem são aceitos?

O parâmetro factor aceita 2 ou 4 e tem 4 como padrão. A entrada pode ser JPEG (JPG), PNG e WebP de até 25 MB, e a saída pode ser devolvida como jpeg (padrão) ou png.

Como funciona o preço da API de ampliação?

O custo acompanha o fator: 2 créditos com factor=2 e 4 créditos com factor=4 (o padrão). O Starter dá 400 créditos por mês por US$ 9,99 e o Pro dá 1.400 por US$ 29,99, e os créditos não usados acumulam enquanto você continuar assinante. Um preço baseado em créditos significa que um mês de muito volume e um mês tranquilo custam o mesmo por imagem.

A API também melhora a qualidade, remove desfoque ou restaura fotos antigas?

A ampliação reconstrói detalhes ao aumentar, o que de quebra dá nitidez a imagens suaves, e o parâmetro sharpen leva esse efeito mais longe para melhorar o resultado. Para fotografias danificadas ou desbotadas — riscos, rasgos, perda de cor — use a API de restauração de fotos, que foi feita para reparar e não para aumentar resolução.

A ampliação é síncrona ou assíncrona?

Síncrona. Não há ID de job para consultar nem webhook para configurar — a imagem ampliada vem no corpo da mesma resposta, com um limite de 60 segundos por requisição.

Posso usar comercialmente as imagens ampliadas?

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.

Vocês armazenam as imagens que eu amplio?

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.

2–4 créditos por chamada

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.

REST · JSON
Sem marca d'água
Nada é armazenado

Obtenha sua chave de API Ver a documentação

endpoint

POST /v1/upscale-image

URL base: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Custo: 2–4 créditos
Entrada: JPEG (JPG), PNG and WebP · max 25 MB

01 — Visão geral

O que é a API de ampliação de imagens?

A API de ampliação de imagens da ImgGen AI é um endpoint REST que aumenta a resolução de uma imagem usando IA em vez de uma interpolação simples. Ela reconstrói bordas, texturas e detalhes finos em vez de esticar pixels, então o resultado continua nítido. Você envia uma imagem e um fator de escala, e o resultado em maior resolução volta na mesma requisição.

É 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 AI Image Upscaler.

02 — Requisição

Parâmetros da requisição

Envie uma requisição POST para https://app.imggen.ai/v1/upscale-image, autenticada com uma chave de API no cabeçalho Authorization.

Parâmetros aceitos por este endpoint
Parâmetro	Tipo	Obrigatório	Padrão	Descrição
image	file	OBRIGATÓRIO	—	Fator de ampliação. Aceita 2 ou 4.
factor	number	opcional	4	Aplica uma reconstrução facial adicional. Útil para retratos e fotos de grupo.
enhanceFace	boolean	opcional	false	Aplica nitidez extra ao resultado ampliado.
sharpen	boolean	opcional	false	Formato de saída. Aceita jpeg ou png.
output	string	opcional	jpeg	Output format. Accepts jpeg or png.

03 — Integração

Como integro a API de ampliação 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/upscale-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form factor=4 \
  --form enhanceFace=false \
  --form sharpen=false \
  --form output=jpeg

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');

const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
  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/upscale-image",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

04 — Resposta

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 upscaled successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — Limites

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.

Escolha seu formato de saída

Use output=png quando precisar de resultado sem perdas ou preservar um canal alfa; jpeg mantém as respostas leves para trabalhos de catálogo em grande volume.

A melhoria facial é opcional

enhanceFace aplica uma reconstrução facial adicional para melhorar e ampliar retratos. Deixe desligado em fotos de produto e paisagens, onde não há rosto a melhorar.

Synchronous by design

There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.

06 — Em produção

Para que serve a API de ampliação de imagens?

Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.

Migração de catálogos antigos

Leve anos de imagens de produto pequenas e de baixa resolução aos padrões atuais de alta resolução em um job em lote, em vez de refotografá-las.

Preparação para impressão

Eleve materiais feitos para web a um tamanho de qualidade que aguenta impressão, com nitidez opcional aplicada na mesma chamada para um resultado mais definido.

Conteúdo gerado por usuários

Amplie avatares e envios pequenos no servidor para que fiquem limpos em telas de alta densidade.

Mídia e acervos

Aumente a resolução de imagens digitalizadas ou comprimidas antes que entrem em um gerenciador de conteúdo, junto com a restauração quando for necessário.

07 — Custo

Quanto custa a API de ampliação de imagens?

Cada chamada bem-sucedida custa 2–4 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.

Planos da ImgGen AI e acesso à API
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.

08 — Relacionado

As equipes que usam a API de ampliação de imagens costumam recorrer a estes em seguida.

→API de restauração de fotos →API de colorização de fotos AI Image Upscaler (ferramenta web)Todos os endpoints da API

Também disponíveis: Remoção de fundo, Remoção de marca d'água, Remoção de texto, Geração de imagens.

FAQ

Perguntas frequentes sobre a API de ampliação de imagens

: É um endpoint HTTP que aumenta a resolução de uma imagem usando um modelo treinado. Em vez de interpolar entre os pixels existentes, como faz um redimensionamento, o modelo prevê o detalhe que uma versão de maior resolução daquela imagem teria — bordas, textura e estrutura — e o reconstrói. Você envia a imagem por POST e lê o resultado ampliado na resposta.
: O parâmetro factor aceita 2 ou 4 e tem 4 como padrão. A entrada pode ser JPEG (JPG), PNG e WebP de até 25 MB, e a saída pode ser devolvida como jpeg (padrão) ou png.
: O custo acompanha o fator: 2 créditos com factor=2 e 4 créditos com factor=4 (o padrão). O Starter dá 400 créditos por mês por US$ 9,99 e o Pro dá 1.400 por US$ 29,99, e os créditos não usados acumulam enquanto você continuar assinante. Um preço baseado em créditos significa que um mês de muito volume e um mês tranquilo custam o mesmo por imagem.
: A ampliação reconstrói detalhes ao aumentar, o que de quebra dá nitidez a imagens suaves, e o parâmetro sharpen leva esse efeito mais longe para melhorar o resultado. Para fotografias danificadas ou desbotadas — riscos, rasgos, perda de cor — use a API de restauração de fotos, que foi feita para reparar e não para aumentar resolução.
: Síncrona. Não há ID de job para consultar nem webhook para configurar — a imagem ampliada vem no corpo da mesma resposta, com um limite de 60 segundos por requisição.
: 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.
: 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 ampliação de imagens

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