Introducción
Qué hace este endpoint
Repara daños visibles en una foto (rayones, manchas de polvo, grano de película, ruido y falta de nitidez) y devuelve un PNG. No requiere prompt.
Entradas importantes
image_url es el único campo: un archivo JPEG, PNG o WebP, o un enlace directo al archivo.
Qué recibes
Un PNG de aproximadamente un megapíxel con la relación de aspecto original. Las fotos en blanco y negro y sepia conservan sus tonos.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Edición de imagen |
| Reparaciones | Rayones, manchas de polvo, grano, ruido y falta de nitidez |
| Color | Se conserva el original; sin colorización |
| Controles | Solo la foto |
Funciones y aspectos destacados
Un retrato sepia con rayones, limpio en una pasada
Nuestro escaneo de prueba tenía cuatro rayones, siete manchas de polvo, grano y desenfoque. Todo desapareció del resultado, y los ojos, la barba y la textura de la chaqueta quedaron más nítidos con el mismo encuadre.
El rostro se repara, no se reemplaza
En el mismo recorte, desaparecieron la mancha de polvo del cabello y el grano de la piel, y la expresión y los rasgos coinciden con el escaneo. Los rostros son la parte más importante de la restauración, así que revísalos primero.
Combínalo con Photo Colorizer
La restauración conserva los tonos originales. Para fotos en blanco y negro o sepia, envía el PNG restaurado a Photo Colorizer; colorear una imagen limpia da un resultado más uniforme que colorear una con rayones.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto escaneada que quieres reparar: un archivo JPEG, PNG o WebP, o un enlace directo. mínimo 1 caracteres |
Precios
$0.048 / imagen
Precio fijo por foto restaurada, sin importar su tamaño. Las solicitudes fallidas no se cobran.
Casos de uso
Álbumes familiares y fotos guardadas
Limpia los escaneos de retratos de tus abuelos, fotos de bodas y vacaciones antes de incluirlos en una presentación, un libro impreso o un chat familiar.
Archivos y proyectos de historia local
Restaura colecciones escaneadas con rayones o manchas de polvo en cada foto para que los voluntarios dediquen su tiempo a los pies de foto en lugar del retoque.
Homenajes y aniversarios
Prepara una foto especial para enmarcarla, incluirla en un programa de ceremonia o en un video homenaje sin contratar a alguien para retocarla.
Guía de prompts y consejos prácticos
Escanea o fotografía la copia
Aplana la foto, evita los reflejos e incluye toda la imagen en el encuadre. La herramienta repara los daños visibles; un reflejo sobre un rostro es más difícil de corregir que un rayón.
Envía
image_urlSube el escaneo en JPEG, PNG o WebP, o proporciona un enlace directo al archivo. Eso es toda la solicitud.
Revisa los rostros y luego agrega color
Compara los ojos y las bocas con el original a tamaño completo. Si la foto es en blanco y negro, envía el PNG restaurado a Photo Colorizer en /models/photo-colorizer-v1.
Introducción
Old Photo Restorer es un endpoint de un solo campo para fotos escaneadas. Envía la foto en image_url y recíbela sin rayones, manchas de polvo, grano ni desenfoque. No agrega color ni solicita un prompt.
Solicitud
{
"image_url": "https://example.com/scan.jpg"
}
Qué observamos en las pruebas
Creamos un escaneo sepia de 640×960 de un retrato en una azotea y agregamos daños habituales: cuatro rayones largos, siete manchas de polvo, grano, desenfoque y compresión JPEG intensa. Tras unos 17 segundos recibimos un PNG de 832×1248 sin rayones ni manchas y con el rostro, la barba y la chaqueta visiblemente más nítidos. El hombre seguía siendo claramente la misma persona. Las nubes tenues se suavizaron hasta formar un cielo claro y uniforme, y el tono sepia se aclaró.
Una foto a color limpia de 2048×1152 regresó a 1360×768 con sus colores conservados y la piel algo más suave. Así funciona el tamaño: el resultado tiene aproximadamente un megapíxel, independientemente de lo que envíes.
Flujo de la tarea
La restauración se ejecuta de forma asíncrona: envía la tarea, consulta su estado hasta que termine y luego descarga el PNG del almacenamiento de SpicyAPI. Cada solicitud procesa una foto a precio fijo; las solicitudes fallidas no tienen costo.
Consejos
- Escanea con una resolución adecuada y recorta la página del álbum o el marco antes de enviar la imagen.
- Los brillos y reflejos son más difíciles de eliminar que los rayones; fotografía las copias sin flash.
- ¿Quieres color? Envía el PNG restaurado a Photo Colorizer (
/models/photo-colorizer-v1). - ¿Necesitas un archivo más grande para imprimir? Usa Image Upscaler (
/models/image-upscaler-v1) después de restaurar.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/photo-restorer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.




