2 créditos por llamada
API de restauración de fotos
Repara fotografías antiguas, dañadas y descoloridas desde tu propio backend. Opcionalmente coloréalas y aumenta su resolución en la misma solicitud, en lugar de encadenar tres llamadas.
- REST · JSON
- Sin marca de agua
- No se almacena nada
POST /v1/image-restoration
¿Qué es la API de restauración de fotos?
La API de restauración de fotos de ImgGen AI es un endpoint REST que repara fotografías dañadas. Reduce arañazos, roturas, manchas, decoloración y desenfoque, y opcionalmente puede añadir color a un original en blanco y negro y aumentar su resolución en la misma llamada. Subes el escaneo y la imagen restaurada se devuelve en la 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 Image Restoration.
Parámetros de la solicitud
Envía una solicitud POST a https://app.imggen.ai/v1/image-restoration, autenticada con una clave de API en la cabecera Authorization.
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| image | file | OBLIGATORIO | — | Añade color realista a una fotografía en blanco y negro mientras la restaura. |
| colorize | boolean | opcional | false | Repara arañazos, roturas y daños físicos. |
| removeTears | boolean | opcional | false | Escala la imagen restaurada para obtener más resolución. Añade el coste del escalador a la llamada. |
| enhanceResolution | boolean | opcional | false | Upscale the restored image for extra resolution. Adds the upscaler cost to the call. |
¿Cómo integro la API de restauración de 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/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"]))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 restored successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}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.
Tres operaciones, una llamada
Reparar, colorear y escalar son parámetros de la misma solicitud y no endpoints distintos, así que una restauración completa es una sola ida y vuelta en lugar de tres.
enhanceResolution tiene un coste extra
Activar enhanceResolution añade el coste del escalador sobre el cargo base de restauración, porque también ejecuta el modelo de escalado.
La calidad del escaneo importa
El modelo reconstruye a partir de lo que puede ver. Un escaneo plano, con iluminación uniforme y a la máxima resolución que admita tu escáner da resultados bastante mejores que una foto de una copia hecha con el móvil.
¿Para qué se usa la API de restauración de fotos?
Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.
Plataformas de genealogía y archivo
Ofrece restauración en un clic de las fotografías familiares que suben tus usuarios sin construir ni alojar un modelo de restauración.
Servicios de digitalización
Ejecuta la restauración automáticamente a medida que salen los escaneos, para que los operarios revisen resultados en lugar de editar cada imagen.
Colecciones de museos y bibliotecas
Genera copias de consulta presentables de material fotográfico deteriorado sin tocar los originales.
Productos de impresión fotográfica
Repara y escala la fotografía que sube un cliente en una sola llamada antes de que pase a imprenta.
¿Cuánto cuesta la API de restauración de 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.
| 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.
Endpoints y herramientas relacionados
Los equipos que usan la API de restauración de fotos suelen recurrir después a estos.
También disponibles: Eliminación de fondos, Eliminación de marcas de agua, Eliminación de texto, Generación de imágenes.
Preguntas frecuentes sobre la API de restauración de fotos
- Es un endpoint HTTP que repara fotografías dañadas de forma automática. Reduce arañazos, roturas, manchas, decoloración y desenfoque, y opcionalmente puede colorear y ampliar el resultado. Existe para que un producto pueda ofrecer restauración a sus usuarios sin que nadie haga retoque a mano.
- Sí. Pon colorize=true y el modelo añadirá color realista dentro de la misma pasada de restauración. Si lo único que necesitas es color y la fotografía no está dañada, el endpoint dedicado de coloreado es la opción más barata y directa.
- Dos créditos por llamada correcta. Poner enhanceResolution=true añade encima el coste del escalador, porque ejecuta un segundo modelo. 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 sigas suscrito.
- Arañazos, roturas, manchas, daños por agua, pérdida de color, amarilleo y falta de nitidez general. Pon removeTears=true específicamente para los daños físicos. Las zonas donde el contenido original ha desaparecido por completo se reconstruyen de forma plausible, no se recuperan: el modelo está infiriendo, no deshaciendo.
- Puede hacerlo, y conviene entenderlo antes de ponerlo delante de tus usuarios. El modelo reconstruye la información que falta por inferencia, así que una cara muy dañada o de muy baja resolución puede volver ligeramente distinta de la persona del original. Trabaja a partir de lo que es visible; donde no hay nada visible, produce una suposición plausible. Trata el resultado como una interpretación restaurada, no como un original recuperado.
- Una fotografía por solicitud. Este endpoint no tiene formato por lotes: solo la eliminación de marcas de agua admite image[]. Para un archivo completo, lanza las solicitudes en paralelo desde tu propio worker; cada una es independiente y cada una se cobra por separado.
- 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.
- Sí. Todos los planes, incluido el gratuito, incluyen derechos de uso comercial completos, y ningún resultado lleva marca de agua. Puedes vender, imprimir o publicar cualquier cosa que devuelva la API.
Empezar
Empieza a llamar a la API de restauración 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