Introducción
Kling O3 Imagen a video anima tu propio cuadro inicial. Sube una imagen, opcionalmente agrega un cuadro final para anclar el desenlace, y describe qué pasa en el medio; el campo prompt admite hasta 2500 caracteres. Elige una duración de 3 a 15 segundos completos, una resolución hasta 4K, y si generar audio nativo con la imagen.
Elige un modo de Kling O3 según tu material de partida
| Lo que tienes al empezar | Modo |
|---|---|
| una escena escrita y nada más | Kling O3 Texto a video |
| un cuadro inicial ya aprobado | Kling O3 Imagen a video |
| hasta 7 fotos de referencia | Kling O3 Referencia a video |
| un video que ya tienes | Kling O3 Video-edit |
Funciones y aspectos destacados
El cuadro inicial se sigue de cerca
Quienes y lo que sea que esté en tu cuadro (las personas, el vestuario, la habitación) es lo que el clip mantiene. En nuestro ejemplo del paraguas, las caras de las dos mujeres coincidieron con el cuadro inicial durante todo un clip de cinco segundos; el prompt solo tuvo que describir la acción nueva.
Un cuadro final opcional ancla el desenlace
Agrega last_image_url y el clip se construye para llegar a ese cuadro en lugar de donde el modelo se detendría de otra forma. Mantén los dos cuadros cercanos en luz, ángulo y encuadre; un salto grande entre ellos es lo que hace que el medio de un clip largo se desvíe.
Sonido generado con el movimiento
generate_audio agrega diálogo, efectos y ambiente en la misma pasada que la animación, sincronizados con la acción que describes en lugar de agregados después en un paso aparte.
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, el movimiento de cámara y, con el sonido activado, el diálogo y los efectos. El cuadro ya fijó quién y dónde. mínimo 1 caracteres · máximo 2500 caracteres |
image_url | Sí | Cuadro inicial. JPEG o PNG. |
last_image_url | No | Cuadro final opcional en el que debe terminar el clip. |
resolution | No | 720p, 1080p o 4K. Los niveles más altos cuestan más por segundo. |
generate_audio | No | Agrega una banda sonora generada en la misma pasada: diálogo entre comillas, efectos, ambiente. Valor predeterminado: |
duration_seconds | No | Segundos completos, de 3 a 15. Determina el precio junto con la resolución y el audio. |
shot_type | No | single pide una sola toma continua (Kling O3 puede seguir cortando por su cuenta; agrega "one continuous shot, no cuts" si importa). multi deja que corte tu prompt en varias tomas. |
multi_prompt | No | La lista de tomas para |
Precios
Se cobra por segundo de salida. La tarifa depende de la resolución y de si el audio nativo está activado.
| Resolución | Generar audio: No | Generar audio: Sí |
|---|---|---|
| $0.0672 / segundo | $0.0896 / segundo |
| $0.0896 / segundo | $0.112 / segundo |
| $0.336 / segundo | $0.336 / segundo |
Casos de uso
Anima un cuadro que ya aprobaste
Cuando las personas, el vestuario y la composición exactos importan, genera o elige la foto fija primero, y luego envíala aquí en lugar de dejar esos detalles a un prompt de texto, que los vuelve a dibujar de cero en cada corrida.
Conecta dos cuadros que ya tienes
Con image_url y last_image_url fijados, el clip rellena un camino de movimiento creíble entre un inicio aprobado y un final aprobado: útil para una escena que tiene que llegar a una composición final específica.
Agrega diálogo a una foto fija que ya te gusta
Activa generate_audio y describe una línea de diálogo junto con la acción; el cuadro aporta el look, el prompt aporta el movimiento y las palabras.
Guía de prompts y consejos prácticos
Describe lo que viene después, no lo que ya está ahí
No vuelvas a describir quién está en el cuadro ni qué lleva puesto: la imagen ya responde eso. Dedica el prompt a lo que cambia: la acción, el movimiento de cámara, el sonido.
Mantén un cuadro final cercano al inicial
Si usas last_image_url, elige o genera un cuadro con luz y encuadre similares al cuadro inicial. Una coincidencia cercana mantiene creíble el movimiento intermedio; un salto grande le pide al modelo inventar más de lo que puede sostener con firmeza.
Fija la toma cuando la continuidad importa
Shot_type single es una preferencia, no una garantía. Para una escena que no debe cortarse (una sola reacción sin interrupciones, por ejemplo) agrega "one continuous shot, no cuts" 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/o3/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.












