¿Qué es una API de coloreado de fotos?

Es un endpoint HTTP que recibe una imagen en blanco y negro y devuelve una versión en color. El modelo lee el contenido de la fotografía —caras, ropa, vegetación, cielo, materiales— y predice colores que encajan, de modo que obtienes un resultado natural sin especificar ninguna paleta.

¿Cómo de precisos son los colores?

Son plausibles, no verificados. El modelo no sabe de qué color era realmente una chaqueta concreta en 1953; produce el coloreado más probable dado todo lo visible en el encuadre. Los tonos de piel, la vegetación y el cielo suelen resultar convincentes porque varían dentro de un rango estrecho; la ropa, las superficies pintadas y otros objetos de color arbitrario son suposiciones informadas. Para material histórico, presenta el resultado como una interpretación.

¿Cuánto cuesta el coloreado?

Dos créditos por llamada correcta. Starter incluye 400 créditos al mes por 9,99 $ y Pro incluye 1.400 por 29,99 $, y los créditos no usados se acumulan mientras tu suscripción siga activa.

¿Cómo integro la API de coloreado en mi aplicación?

Crea una clave de API en tu cuenta de ImgGen y envía por POST un formulario multipart con un campo image a https://app.imggen.ai/v1/colorize-photo, autenticándote con una cabecera Authorization: Bearer. Decodifica el campo image en base64 de la respuesta JSON y guárdalo donde almacenes tus recursos. En esta página tienes ejemplos en cURL, Node.js y Python.

¿Qué diferencia hay entre esto y la API de restauración?

Este endpoint está pensado para añadir color y opcionalmente puede reparar roturas. El endpoint de restauración está pensado para reparar daños y opcionalmente puede añadir color. Si la fotografía está sobre todo dañada, usa restauración; si simplemente está en blanco y negro, usa este.

¿Qué formatos y tamaños se admiten?

La API acepta archivos JPEG (JPG), PNG y WebP de hasta 25 MB por imagen. Los resultados se devuelven como una imagen codificada en base64 dentro de la respuesta JSON.

¿Almacenáis las imágenes que envío?

No. La API no guarda estado: no crea ningún proyecto, no guarda ningún archivo ni conserva tu imagen. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó. Tus imágenes nunca se usan para entrenar modelos.

2 créditos por llamada

API de coloreado de fotos

Convierte fotografías en blanco y negro en imágenes con color natural con una sola solicitud. Reparación de roturas opcional en la misma llamada y sin elegir colores a mano en ningún momento.

REST · JSON
Sin marca de agua
No se almacena nada

Obtén tu clave de API Ver la documentación

endpoint

POST /v1/colorize-photo

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

01 — Resumen

¿Qué es la API de coloreado de fotos?

La API para colorear fotos de ImgGen AI es un endpoint REST que añade color realista a imágenes en blanco y negro o en escala de grises. El modelo infiere colores plausibles para la piel, la ropa, la vegetación, el cielo y los materiales a partir del propio contenido de la imagen, así que no hace falta ninguna paleta de referencia ni selección manual. El resultado con color se devuelve en la misma respuesta.

Es uno de los siete endpoints de la API de edición de imágenes de ImgGen AI, que comparten una única clave de API, una única URL base y la misma forma de solicitud y respuesta. Si además necesitas esta función en el navegador y no desde código, el mismo modelo de IA impulsa la herramienta Colorize Photo.

02 — Solicitud

Parámetros de la solicitud

Envía una solicitud POST a https://app.imggen.ai/v1/colorize-photo, autenticada con una clave de API en la cabecera Authorization.

Parámetros que acepta este endpoint
Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
image	file	OBLIGATORIO	—	Repara arañazos y roturas mientras colorea.
removeTears	boolean	opcional	false	Repair scratches and tears while colorizing.

03 — Integración

¿Cómo integro la API para colorear fotos?

Crea una clave de API en tu cuenta de ImgGen, guárdala como variable de entorno y llama al endpoint. Esta es la misma solicitud en cURL, Node.js y 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 — Respuesta

Respuesta

Una llamada correcta devuelve JSON. El resultado viene codificado en base64: decodifícalo antes de escribirlo en disco o en tu almacenamiento de objetos. Cada respuesta correcta incluye además una cabecera X-Credit-Remaining con tu saldo tras la llamada.

{
  "success": true,
  "message": "Image colorized successfully",
  "image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}

05 — Límites

Límites y comportamientos que conviene conocer

El endpoint acepta JPEG (JPG), PNG y WebP con un tamaño máximo de archivo de 25 MB, y responde de forma síncrona en menos de 60 segundos: no hay ningún trabajo que consultar ni ningún webhook que configurar.

El color se infiere, no se recupera

El modelo predice un color plausible a partir del contenido de la imagen. Produce una interpretación convincente, no una verificada históricamente: conviene decirlo con claridad si muestras los resultados a tus usuarios.

Repara mientras coloreas

Pon removeTears=true para arreglar arañazos y daños físicos en la misma pasada, sin una segunda llamada al endpoint de restauración.

Imágenes que ya tienen color

El endpoint está pensado para entradas en escala de grises. Enviar una imagen que ya tiene color no aporta nada: usa el endpoint de restauración si lo que buscas es reparar.

06 — En producción

¿Para qué se usa la API para colorear fotos?

Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.

Productos de historia familiar

Permite a tus usuarios colorear las fotografías heredadas dentro de tu aplicación como mejora de pago o función de fidelización.

Medios y publicación

Produce versiones en color de fotografía de archivo para reportajes y retrospectivas, siempre claramente etiquetadas como interpretaciones.

Procesamiento masivo de archivos

Genera copias de consulta en color de toda una colección en escala de grises sin tocar los originales.

Servicios conmemorativos y de regalo

Colorea y repara automáticamente la fotografía que sube un cliente como parte del flujo de pedidos.

07 — Coste

¿Cuánto cuesta la API para colorear fotos?

Cada llamada correcta cuesta 2 créditos, así que tu coste real por imagen depende del plan que tengas. Los créditos salen de tu plan y se comparten entre todos los endpoints y el editor web, de modo que no compras una cuota separada por herramienta. Una llamada fallida se reembolsa automáticamente. Consulta todos los detalles en la página de precios.

Planes de ImgGen AI y acceso a la API
Plan	Precio	Créditos	API
Free	$0	50 créditos gratuitos de una sola vez	Sin acceso a la API
Starter	$9.99 / month	400 créditos / mes	Acceso a la API incluido
Pro	$29.99 / month	1.400 créditos / mes	Acceso a la API + soporte prioritario
Enterprise	Custom	Volumen personalizado	Infraestructura dedicada

Costes en créditos y límites verificados por última vez el 2026-08-27.

08 — Relacionado

Los equipos que usan la API para colorear fotos suelen recurrir después a estos.

→API de restauración de fotos →API de escalado de imágenes Colorize Photo (herramienta web)Todos los endpoints de la API

También disponibles: Eliminación de fondos, Eliminación de marcas de agua, Eliminación de texto, Generación de imágenes.

FAQ

Preguntas frecuentes sobre la API de coloreado de fotos

: Es un endpoint HTTP que recibe una imagen en blanco y negro y devuelve una versión en color. El modelo lee el contenido de la fotografía —caras, ropa, vegetación, cielo, materiales— y predice colores que encajan, de modo que obtienes un resultado natural sin especificar ninguna paleta.
: Son plausibles, no verificados. El modelo no sabe de qué color era realmente una chaqueta concreta en 1953; produce el coloreado más probable dado todo lo visible en el encuadre. Los tonos de piel, la vegetación y el cielo suelen resultar convincentes porque varían dentro de un rango estrecho; la ropa, las superficies pintadas y otros objetos de color arbitrario son suposiciones informadas. Para material histórico, presenta el resultado como una interpretación.
: Dos créditos por llamada correcta. Starter incluye 400 créditos al mes por 9,99 $ y Pro incluye 1.400 por 29,99 $, y los créditos no usados se acumulan mientras tu suscripción siga activa.
: Crea una clave de API en tu cuenta de ImgGen y envía por POST un formulario multipart con un campo image a https://app.imggen.ai/v1/colorize-photo, autenticándote con una cabecera Authorization: Bearer. Decodifica el campo image en base64 de la respuesta JSON y guárdalo donde almacenes tus recursos. En esta página tienes ejemplos en cURL, Node.js y Python.
: Este endpoint está pensado para añadir color y opcionalmente puede reparar roturas. El endpoint de restauración está pensado para reparar daños y opcionalmente puede añadir color. Si la fotografía está sobre todo dañada, usa restauración; si simplemente está en blanco y negro, usa este.
: La API acepta archivos JPEG (JPG), PNG y WebP de hasta 25 MB por imagen. Los resultados se devuelven como una imagen codificada en base64 dentro de la respuesta JSON.
: No. La API no guarda estado: no crea ningún proyecto, no guarda ningún archivo ni conserva tu imagen. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó. Tus imágenes nunca se usan para entrenar modelos.

Empezar

Empieza a llamar a la API de coloreado de fotos

Una sola clave desbloquea los siete endpoints. Sin marca de agua, con derechos comerciales completos y sin que se almacene nada de lo que envías una vez devuelta la respuesta.

Obtén tu clave de API