Introducción
Qué hace este endpoint
Agrega color a una foto en blanco y negro, sepia o descolorida y devuelve un JPEG. Los colores se infieren de la imagen; no hay prompt ni paleta.
Entradas importantes
image_url es el único campo: la foto como archivo JPEG, PNG o WebP, o un enlace directo.
Qué recibes
Un JPEG con dimensiones de aproximadamente dos a tres veces las originales.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Edición de imagen |
| Controles | Solo la foto |
| Mejores resultados con | Escaneos limpios; restaura primero las fotos dañadas |
Funciones y aspectos destacados
Un retrato gris en una azotea se convierte en una escena al atardecer
A partir de una foto en blanco y negro, la herramienta creó piel cálida, una chaqueta café, un cielo de atardecer entre azul y naranja y ventanas iluminadas en la ciudad. Ninguno de esos colores estaba en el archivo; se infirieron de las formas y los tonos.
De una foto sepia con rayones a una imagen a color limpia
Izquierda: el escaneo dañado. Centro: el mismo escaneo después de Old Photo Restorer. Derecha: el archivo restaurado después de Photo Colorizer. Colorear la imagen limpia mantuvo la piel uniforme y el cielo suave.
Los colores se infieren de la imagen
Una foto en blanco y negro no contiene información de color; cada tono es la mejor interpretación del modelo. Considera el resultado una interpretación de aspecto natural y conserva el original a su lado.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto en blanco y negro, sepia o descolorida que quieres colorear: un archivo JPEG, PNG o WebP, o un enlace directo. mínimo 1 caracteres |
Precios
$0.06 / imagen
Precio fijo por foto coloreada; la salida de mayor tamaño no tiene costo adicional. Las solicitudes fallidas no se cobran.
Casos de uso
Dale vida a la historia familiar
Ofrece a tus familiares una versión a color del retrato de un padre o abuelo para colocar junto al original en un álbum o una página conmemorativa.
Contenido histórico y documental
Colorea imágenes de archivo para un ensayo en video, un texto de museo o una publicación en redes, y conserva el original al lado para comparar.
Flujos de restauración
Úsalo después de Old Photo Restorer: primero repara, luego colorea y, si necesitas imprimir, aumenta la resolución.
Guía de prompts y consejos prácticos
Empieza con un escaneo limpio
La colorización funciona mejor en imágenes sin rayones ni polvo. Si la foto está dañada, usa primero Old Photo Restorer (/models/photo-restorer-v1) y colorea el resultado.
Envía
image_urlSube la foto en blanco y negro o sepia en JPEG, PNG o WebP, o proporciona un enlace directo al archivo.
Revisa los colores estimados
Los colores del cabello, los ojos y la ropa se infieren, no se recuperan. Si conoces los reales, usa el resultado como punto de partida para un retoque manual.
Introducción
Photo Colorizer agrega colores naturales a fotos en blanco y negro, sepia y descoloridas. La única entrada es image_url; los colores de piel, cabello, ropa, cielo y edificios se infieren de las formas y los tonos de la imagen.
Solicitud
{
"image_url": "https://example.com/grandparents-1958.jpg"
}
Qué observamos en las pruebas
Un retrato en blanco y negro de 768×1152 de un hombre en una azotea regresó tras unos 17 segundos como JPEG de 1664×2496: piel cálida, chaqueta café, camiseta blanca y atardecer naranja detrás de la silueta azul de la ciudad. Una foto de 1024×576 de dos personas en un bar regresó a 2848×1600 con botellas de vino verdes y rojas y un suéter color crema. El cabello de la mujer quedó castaño, aunque era rojo en la foto a color que habíamos convertido: ese es el tipo de estimación que conviene revisar.
También coloreamos un escaneo sepia con rayones después de procesarlo con Old Photo Restorer. El retrato restaurado y luego coloreado tuvo piel uniforme y un cielo limpio.
Flujo de la tarea
La llamada es asíncrona: crea la tarea, consulta su estado hasta que termine y descarga el JPEG del almacenamiento de SpicyAPI. Cada solicitud procesa una foto a precio fijo; las solicitudes fallidas son gratuitas.
Consejos
- Repara primero los rayones y el polvo con Old Photo Restorer (
/models/photo-restorer-v1); los daños dificultan la colorización. - Si conoces un color con certeza (uniforme, automóvil, vestido), corrígelo a mano después.
- Conserva el original en blanco y negro e identifica la copia coloreada al publicar imágenes históricas.
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-colorizer-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.




