O que é uma API de colorização de fotos?

É um endpoint HTTP que recebe uma imagem em preto e branco e devolve uma versão colorida. O modelo lê o conteúdo da fotografia — rostos, roupas, vegetação, céu, materiais — e prevê cores que combinam, então você obtém um resultado natural sem especificar paleta.

Quão precisas são as cores?

São plausíveis, não verificadas. O modelo não sabe de que cor uma jaqueta específica realmente era em 1953; ele produz a coloração mais provável dado tudo que está visível no enquadramento. Tons de pele, vegetação e céu costumam convencer porque variam dentro de uma faixa estreita; roupas, superfícies pintadas e outros objetos de cor arbitrária são palpites informados. Para material histórico, apresente o resultado como uma interpretação.

Quanto custa a colorização?

Dois créditos por chamada bem-sucedida. 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 a assinatura estiver ativa.

Como integro a API de colorização na minha aplicação?

Crie uma chave de API na sua conta ImgGen e envie por POST um formulário multipart com um campo image para https://app.imggen.ai/v1/colorize-photo, autenticando com um cabeçalho Authorization: Bearer. Decodifique o campo image em base64 da resposta JSON e grave onde você guarda seus arquivos. Há exemplos em cURL, Node.js e Python nesta página.

Qual a diferença entre isto e a API de restauração?

Este endpoint foi feito para acrescentar cor e opcionalmente pode reparar rasgos. O endpoint de restauração foi feito para reparar danos e opcionalmente pode acrescentar cor. Se a fotografia está sobretudo danificada, use restauração; se ela é apenas preto e branco, use este.

Quais formatos e tamanhos são aceitos?

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.

Vocês armazenam as imagens que envio?

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 créditos por chamada

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.

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

Obtenha sua chave de API Ver a documentação

endpoint

POST /v1/colorize-photo

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

01 — Visão geral

O que é a API de colorização de fotos?

A API para colorizar fotos da ImgGen AI é um endpoint REST que acrescenta cor realista a imagens em preto e branco ou em escala de cinza. O modelo infere cores plausíveis para pele, roupas, vegetação, céu e materiais a partir do próprio conteúdo da imagem, então nenhuma paleta de referência ou seleção manual é necessária. O resultado colorido é devolvido 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 Colorize Photo.

02 — Requisição

Parâmetros da requisição

Envie uma requisição POST para https://app.imggen.ai/v1/colorize-photo, 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	—	Repara riscos e rasgos enquanto colorriza.
removeTears	boolean	opcional	false	Repair scratches and tears while colorizing.

03 — Integração

Como integro a API para colorizar 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/colorize-photo' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form removeTears=false

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');

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

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 colorized 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.

A cor é inferida, não recuperada

O modelo prevê uma cor plausível a partir do conteúdo da imagem. Ele produz uma interpretação convincente, não uma verificada historicamente — vale dizer isso com clareza se você mostrar os resultados aos seus usuários.

Repare enquanto colorriza

Defina removeTears=true para corrigir riscos e danos físicos na mesma passagem, sem uma segunda chamada ao endpoint de restauração.

Imagens que já têm cor

O endpoint foi feito para entradas em escala de cinza. Enviar uma imagem que já tem cor não ajuda — use o endpoint de restauração se o objetivo for reparar.

06 — Em produção

Para que serve a API para colorizar fotos?

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

Produtos de história familiar

Deixe seus usuários colorizarem fotografias herdadas dentro do seu app como upgrade pago ou recurso de engajamento.

Editorial e publicação

Produza versões coloridas de fotografia de acervo para reportagens e retrospectivas, sempre claramente identificadas como interpretações.

Processamento de acervos em massa

Gere cópias de consulta coloridas de toda uma coleção em escala de cinza mantendo os originais intocados.

Serviços memoriais e de presente

Colorize e repare automaticamente a fotografia enviada por um cliente como parte do fluxo de pedidos.

07 — Custo

Quanto custa a API para colorizar 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.

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 para colorizar fotos costumam recorrer a estes em seguida.

→API de restauração de fotos →API de ampliação de imagens Colorize Photo (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 colorização de fotos

: É um endpoint HTTP que recebe uma imagem em preto e branco e devolve uma versão colorida. O modelo lê o conteúdo da fotografia — rostos, roupas, vegetação, céu, materiais — e prevê cores que combinam, então você obtém um resultado natural sem especificar paleta.
: São plausíveis, não verificadas. O modelo não sabe de que cor uma jaqueta específica realmente era em 1953; ele produz a coloração mais provável dado tudo que está visível no enquadramento. Tons de pele, vegetação e céu costumam convencer porque variam dentro de uma faixa estreita; roupas, superfícies pintadas e outros objetos de cor arbitrária são palpites informados. Para material histórico, apresente o resultado como uma interpretação.
: Dois créditos por chamada bem-sucedida. 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 a assinatura estiver ativa.
: Crie uma chave de API na sua conta ImgGen e envie por POST um formulário multipart com um campo image para https://app.imggen.ai/v1/colorize-photo, autenticando com um cabeçalho Authorization: Bearer. Decodifique o campo image em base64 da resposta JSON e grave onde você guarda seus arquivos. Há exemplos em cURL, Node.js e Python nesta página.
: Este endpoint foi feito para acrescentar cor e opcionalmente pode reparar rasgos. O endpoint de restauração foi feito para reparar danos e opcionalmente pode acrescentar cor. Se a fotografia está sobretudo danificada, use restauração; se ela é apenas preto e branco, use este.
: 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 colorizaçã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