Introducción
Qué hace este endpoint
Repara un video en uno de dos modos: decompress elimina macrobloques, halos, bandas y contaminación de color; deblur recupera la nitidez de videos fuera de foco. Conserva encuadre, movimiento, duración y audio.
Entradas importantes
video_url es el clip, de hasta 120 segundos. restore_mode elige la reparación y resolution el tamaño de salida, que nunca supera el original. prompt y seed son opcionales.
Qué recibes
Un MP4 con la relación de aspecto, velocidad de fotogramas y audio originales.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Endpoint | Edición de video |
| Modos | decompress (daños de codificación) o deblur (falta de foco) |
| Opcional | Descripción de la escena y seed |
| Cobro | Por segundo del original según resolución, mínimo de 3 segundos |
Funciones y aspectos destacados
Sin macrobloques, con rostros reconstruidos
Comprimimos un clip de invernadero de 4 segundos a 116 kbps hasta que el rostro de la mujer se convirtió en bloques. El modo decompress devolvió un clip limpio de 854×480 con rizos, sonrisa y orquídeas nítidos, conservando duración y velocidad de fotogramas.
Una toma de dos personas recupera el foco
Una conversación en una cava, desenfocada para simular un fallo de enfoque, regresó con rostros, cabello y barriles de madera nítidos. Ambas personas conservaron sus posiciones y movimientos.
Primero restaura, luego amplía
La restauración trabaja al tamaño original o por debajo de él. Si también necesitas ampliar el clip reparado, envíalo a Video Upscaler; ampliar un video con bloques solo agranda los bloques.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El clip que quieres restaurar, de hasta 120 segundos: archivo MP4 o WebM, o enlace directo. Los clips más largos se rechazan al enviarlos y no se cobran. mínimo 1 caracteres |
restore_mode | No | decompress (predeterminado) elimina macrobloques, halos, bandas y contaminación de color de videos de baja tasa de bits. |
prompt | No | Opcional. Descripción breve de lo que muestra el video, como "a man and a woman talking in a wine cellar", para conservar los detalles correctos. máximo 1000 caracteres |
resolution | No | Resolución de salida: 480p, 720p (predeterminada) o 1080p. Se conserva la relación de aspecto y el resultado nunca supera el tamaño original. |
seed | No | Entero opcional para resultados repetibles; déjalo vacío para un seed aleatorio. No cambia el precio. |
Precios
Cobro por segundo del clip original a la resolución de salida elegida, redondeado al segundo superior y con mínimo de 3 segundos. Se rechazan clips de más de 120 segundos. El modo, prompt y seed no cambian el precio. Las solicitudes fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
| $0.12 / segundo |
Casos de uso
Recupera clips compartidos varias veces
Los videos que pasan por varias aplicaciones y se vuelven a subir acumulan bloques y manchas. El modo decompress recupera la limpieza de rostros, cabello y texturas.
Rescata una toma poco nítida
Si el enfoque automático falló o el sujeto salió del plano de enfoque, deblur puede recuperar una toma utilizable sin volver a grabar.
Antes de aumentar la resolución
Restaura primero al tamaño original y luego envía el clip limpio a Video Upscaler si necesitas 1080p o 4K.
Guía de prompts y consejos prácticos
Elige el modo según el daño
Usa decompress para macrobloques, bandas y contaminación de color por compresión intensa. Usa deblur si el lente no enfocó bien; no corrige el desenfoque por movimiento.
Elige la resolución de salida
Elige 480p, 720p o 1080p. Se conserva la relación de aspecto y el resultado nunca supera el tamaño original. Elige una resolución igual o inferior a la altura del clip; el precio depende de la resolución elegida.
Describe la escena si los detalles importan
Un prompt opcional como "a woman with curly hair in a greenhouse full of orchids" ayuda a conservar los detalles correctos. Agrega seed para repetir un resultado.
Introducción
Video Restorer limpia videos dañados sin cambiar lo que ocurre en ellos. Elige decompress para clips afectados por bajas tasas de bits y subidas repetidas, o deblur si el lente no enfocó bien. Los sujetos, el encuadre y el movimiento se conservan.
Solicitud
{
"video_url": "https://example.com/clip.mp4",
"restore_mode": "decompress",
"resolution": "720p",
"prompt": "a woman with curly hair in a greenhouse full of orchids"
}
Solo video_url es obligatorio. restore_mode usa decompress por defecto y resolution, 720p. Se conserva la relación de aspecto y el resultado nunca supera el tamaño original: un clip de 480p regresa a 480p aunque pidas más.
Qué observamos en las pruebas
Comprimimos un clip de invernadero de 4 segundos y 854×480 a 116 kbps, hasta convertir el rostro de la mujer en bloques. En modo decompress a 480p regresó tras unos 55 segundos con rostro, rizos y orquídeas limpios, aún con 4 segundos, 24 fps y audio estéreo. Un clip de cava de 4 segundos, desenfocado para simular un fallo de enfoque, regresó en modo deblur tras unos 72 segundos con rostros y barriles nítidos.
Flujo de la tarea
La llamada es asíncrona: crea la tarea, consulta su estado hasta que termine y descarga el MP4 del almacenamiento de SpicyAPI. Se cobra por segundo del original a la resolución elegida; las solicitudes fallidas no se cobran.
Consejos
- Elige una
resolutionigual o inferior a la altura original; un ajuste mayor cuesta más sin agregar píxeles. deblurcorrige la falta de foco. No corrige desenfoque por movimiento ni videos con temblores.- Para ampliar el clip reparado, envíalo después a Video Upscaler (
/models/video-upscaler-v1).
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-restorer-v1/video-edit",
"input": {
"resolution": "720p",
"restore_mode": "decompress",
"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.


