Introducción
Qué hace este endpoint
Toma una imagen y devuelve una copia más grande y nítida en el nivel de tamaño que elijas. La composición, los colores y el sujeto quedan como los enviaste, y no hay prompt.
Entradas que importan
image_url es la imagen que se amplía. resolution elige el nivel: 2k (unos 4 megapíxeles), 4k (unos 17, el predeterminado) u 8k (unos 67). La proporción se conserva y un nivel menor que el original reduce la imagen. output_format fija el tipo de archivo: jpeg (predeterminado), png o webp.
Qué recibes
Una imagen por solicitud, servida desde el almacenamiento de la plataforma cuando termina la tarea.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Escalado |
| Niveles de tamaño | 2K (~4 MP), 4K (~17 MP), 8K (~67 MP) |
| Proporción | La del original |
| Controles | Sin prompt: solo nivel de tamaño y formato de archivo |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Un enlace directo al archivo de imagen (JPEG, PNG o WebP). El encuadre y la proporción se mantienen sin cambios. mínimo 1 caracteres |
resolution | No | 2k (unos 4 MP), 4k (unos 17 MP, el predeterminado) u 8k (unos 67 MP), con la proporción intacta. |
output_format | No | jpeg (predeterminado) mantiene archivos manejables: unos 8 MB incluso en el nivel más grande en nuestra prueba. |
Precios
$0.012 / imagen
Se cobra por imagen generada. El nivel de tamaño y el formato de archivo no cambian el precio.
Casos de uso
Renders de IA a tamaño de impresión
La mayoría de los modelos de imagen entregan uno o dos megapíxeles. Con 4k u 8k llevas un render a tamaño de póster o de impresión sin volver a generarlo ni perder la toma que te gustó.
Fotos de producto y catálogo
Amplía una foto de producto para vistas con zoom y páginas de alta densidad mientras la iluminación y la etiqueta quedan exactamente como se tomaron.
Imágenes pequeñas para diseños nuevos
Lleva una miniatura, una foto de tamaño web o un recurso antiguo al tamaño que hoy pide un banner principal o una diapositiva.
Guía de prompts y consejos prácticos
Revisa el tamaño del original
Elige un nivel por encima de los píxeles actuales: un nivel menor reduce la imagen. Escala al final, después de todas las ediciones, para que los pasos siguientes no carguen con el archivo más grande.
Envía
image_urly resolutionimage_urles la imagen y resolution elige 2k, 4k (predeterminado) u 8k. Agregaoutput_formatsolo si quieres png o webp en lugar de jpeg.Consulta y descarga
La llamada es asíncrona: crea la tarea, consúltala hasta que termine y descarga el archivo del almacenamiento de la plataforma. Un jpeg en 8k pesa unos 8 MB, así que calcula el tiempo de descarga.
Introducción
Image Upscaler amplía una imagen terminada al nivel 2k, 4k u 8k y la afina en el camino. La imagen en sí no cambia: la composición, los colores y el sujeto quedan exactamente como los enviaste. No hay prompt ni nada que ajustar aparte del tamaño y el formato de archivo.
Solicitud
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
Solo image_url es obligatorio. resolution es 4k de forma predeterminada y output_format es jpeg.
Cómo se comportan los niveles
El nivel es un presupuesto de píxeles, no un lienzo fijo, y la proporción siempre se conserva. Una foto de 1024×1536 volvió en 1672×2508 con 2k, en 3344×5017 con 4k y en 6689×10033 con 8k, cada vez en unos 45 segundos. Un original que ya es más grande que el nivel se reduce: una imagen de 3344×5017 enviada con 2k volvió en 1672×2509.
Flujo de la tarea
La llamada es asíncrona. Crea la tarea, consúltala hasta que llegue a un estado final y descarga la imagen del almacenamiento de la plataforma. Vuelve una imagen por solicitud.
Consejos
- Elige un nivel por encima de los píxeles del original.
- Escala al final, después de todas las ediciones, para que los pasos siguientes no procesen el archivo más grande.
- Empieza por el original más limpio que tengas: los artefactos de compresión y el desenfoque también se amplían.
- Usa
jpegsalvo que necesites una salida sin pérdida. Nuestro jpeg en 8k pesó unos 8 MB; unpngpesa varias veces más.
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/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "4k"
}
}'
# 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.
