Introducción
Kling 2.5 Turbo Imagen a video anima un cuadro inicial en un clip de 5 o 10 segundos en 1080p, con una pista de audio real generada en la misma pasada. Agrega un cuadro final opcional (last_image_url) para fijar el desenlace; la relación de aspecto de salida sigue el cuadro que envíes, ambos solo JPEG o PNG.
Elige un modo de Kling 2.5 Turbo según tu material de partida
| Lo que tienes al empezar | Modo |
|---|---|
| una escena escrita | Kling 2.5 Turbo Texto a video |
| un cuadro inicial ya aprobado | Kling 2.5 Turbo Imagen a video |
Funciones y aspectos destacados
Un cuadro final opcional
last_image_url no es obligatorio, pero cuando lo fijas, el clip se construye para llegar exactamente a ese cuadro en lugar de donde el modelo decida detenerse. Nada fija el medio del clip, así que mantén los dos cuadros cercanos en luz, pose y encuadre para el resultado más fluido.
El sonido llega junto con la imagen
La pista de audio se genera en la misma pasada que el video: no hay ningún campo para silenciarla. Escribe cómo debe sonar la escena en el prompt, el mismo lugar donde escribes la acción.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe solo lo que pasa después del cuadro inicial: la acción y el movimiento de cámara. mínimo 1 caracteres · máximo 2500 caracteres |
image_url | Sí | Cuadro inicial. Solo JPEG o PNG. |
last_image_url | No | Cuadro final opcional. Cuando lo fijas, el clip se construye para llegar a él; de lo contrario el medio no está fijado. |
duration_seconds | No | Segundos completos, 5 o 10. Determina el precio. |
negative_prompt | No | Una lista corta de lo que el clip debe evitar. máximo 500 caracteres |
guidance_scale | No | De 0 a 1. Más alto se apega más a tu redacción; más bajo le da al modelo más libertad. |
Precios
$0.056 / segundo
Se cobra por segundo del clip de salida en 1080p. Una imagen que Kling rechaza no se cobra.
Casos de uso
Da vida a un cuadro ya aprobado
Parte de una foto fija que ya te gusta (un retrato, una foto de producto, una pieza de arte conceptual) y describe solo lo que pasa después; el cuadro en sí no cambia.
Encadena cuadro a cuadro a lo largo de una escena más larga
Envía el último cuadro de un clip ya aprobado como el cuadro inicial del siguiente, y usa last_image_url en este nuevo clip para llegar a una pose específica: útil para enlazar varios clips de 5 o 10 segundos en una sola escena continua.
Guía de prompts y consejos prácticos
Describe solo lo que cambia
El cuadro inicial ya define el sujeto, el vestuario y el entorno; el prompt solo necesita decir qué pasa después: la acción, el movimiento de cámara y cómo suena.
Mantén ambos cuadros cercanos al usar last_image_url
Un cuadro de cierre que difiere mucho en pose, luz o encuadre respecto al cuadro inicial le da al modelo más trabajo para reconciliar el espacio entre ambos, y el medio puede desviarse en un clip de 10 segundos. Mantén ambos cuadros cercanos y deja que el prompt lleve el movimiento entre ellos.
Escribe el sonido en la misma frase que el movimiento
Como el audio se genera junto con la imagen en cada clip, describe cómo suena un movimiento justo donde describes el movimiento mismo -pasos, tela, viento, ruido lejano de una multitud- en lugar de tratar el sonido como una idea añadida al final del prompt.
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": "kling/2.5-turbo/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
