Introducción
Qué hace este endpoint
Toma un clip de video y devuelve el mismo clip en un nivel de resolución más alto. La duración, la proporción, el movimiento, los cortes y la pista de audio quedan como los enviaste, y no hay prompt.
Entradas que importan
video_url es el clip, de 3 a 60 segundos, como enlace directo al archivo. resolution elige el nivel de salida: 720p, 1080p (el predeterminado), 2k o 4k. El nivel es un presupuesto de píxeles, así que un clip de 832×480 vuelve en 1896×1094 con 1080p.
Qué recibes
Un MP4 por solicitud, con la misma duración que el original, servido desde el almacenamiento de la plataforma cuando termina la tarea.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Endpoint | Escalado |
| Niveles | 720p, 1080p, 2K, 4K |
| Cobro | Por segundo del clip de origen, redondeado hacia arriba, mínimo 3 segundos |
| Controles | Sin prompt: solo resolution |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El clip que se escala, de 3 a 60 segundos. mínimo 1 caracteres |
resolution | No | 720p, 1080p (el predeterminado), 2k o 4k: un presupuesto de píxeles con la proporción del clip intacta, así que un clip de 832×480 en 1080p vuelve en 1896×1094. |
Precios
Se cobra por segundo del clip de origen, redondeado al segundo entero siguiente con un mínimo de 3 segundos; el nivel de salida fija la tarifa por segundo. La estimación previa al envío usa la duración de un clip cargado más un segundo, o el máximo de 60 segundos si es una URL de video, y la diferencia se libera al liquidar la tarea.
| Especificación | Precio |
|---|---|
| $0.006 / segundo |
| $0.006 / segundo |
| $0.012 / segundo |
| $0.024 / segundo |
Casos de uso
Borradores en 480p con calidad de entrega
Genera barato en 480p o 720p, quédate con la toma que te gusta y escala solo esa, en lugar de pagar cada intento en alta resolución.
Cortes para redes y anuncios
Lleva clips cortos a la resolución que espera un feed, una landing page o un espacio publicitario, con la banda sonora en su lugar.
Material antiguo en pantallas grandes
Da a pequeños clips de archivo o grabaciones de pantalla una imagen más limpia y grande para presentaciones y pantallas grandes.
Guía de prompts y consejos prácticos
Termina el montaje y luego escala
Escala la versión final. Si no, cada paso posterior tendría que procesar varias veces más píxeles.
Envía
video_urly resolutionvideo_urles el clip, de 3 a 60 segundos; resolution elige 720p, 1080p (predeterminado), 2k o 4k. No hay nada más que configurar.Consulta y descarga
La llamada es asíncrona: crea la tarea, consúltala hasta que termine y descarga el MP4 del almacenamiento de la plataforma. Un clip de 5 segundos en 4K pesa unos 19 MB.
Introducción
Video Upscaler toma un clip terminado y lo devuelve en un nivel de resolución más alto. Es una pasada de resolución, no un editor: el encuadre, el movimiento, los cortes, el ritmo y la pista de audio original quedan como los enviaste. No hay prompt.
Solicitud
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Solo video_url es obligatorio. resolution es 1080p de forma predeterminada; los otros niveles son 720p, 2k y 4k.
Duración del clip y cobro
El clip debe durar de 3 a 60 segundos. Si la duración se conoce al aceptar la tarea, un clip fuera de ese rango se rechaza de inmediato; si no, se revisa antes de empezar el proceso y la tarea falla con reembolso completo. Se cobra por segundo del clip de origen, redondeado al segundo entero siguiente con un mínimo de 3 segundos, a la tarifa del nivel elegido. La estimación previa al envío usa la duración de un clip cargado más un segundo, o el máximo de 60 segundos si es una URL de video; la parte no usada de la retención se libera al liquidar.
Qué vuelve
El nivel es un presupuesto de píxeles y la proporción se conserva. Un clip de 832×480 volvió en 1896×1094 con 1080p tras unos 33 segundos de proceso, y en 3792×2188 con 4k tras unos 103 segundos; un MP4 de 5 segundos en 4k pesa unos 19 MB. Un clip de 854×480 con pista AAC volvió en 1922×1080 con la misma pista. En todas las pruebas la duración coincidió con el original fotograma a fotograma.
Flujo de la tarea
La llamada es asíncrona. Crea la tarea, consúltala hasta que llegue a un estado final y descarga el MP4 del almacenamiento de la plataforma.
Consejos
- Escala el montaje final, después de todas las ediciones.
- Elige un nivel por encima de la resolución actual del clip.
- Usa un enlace directo al archivo de video. Una página web que reproduce el video devuelve HTML, la duración no se puede leer y la llamada falla con reembolso; subir el archivo es la vía más confiable.
- Empieza por el original más limpio que tengas: los bloques de compresión y el ruido también se amplían.
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/video-upscaler-v1/upscale",
"input": {
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
