Introducción
Kling O3 Referencia a video arma una toma a partir de hasta 7 fotos de referencia (personajes, atuendos, objetos o lugares) en lugar de un solo cuadro inicial. Numera las referencias en el prompt (Imagen 1, Imagen 2, y así sucesivamente) y di qué aporta cada una; el campo prompt admite hasta 2500 caracteres. Elige una duración de 3 a 15 segundos completos, una resolución hasta 4K, una relación de aspecto, y si generar audio nativo.
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
Varias referencias, una sola toma
A diferencia de imagen a video, que parte de un solo cuadro, referencia a video toma hasta 7 fotos separadas y combina lo que muestra cada una. Nuestro ejemplo del vagón comedor usó tres: un hombre, una habitación y un objeto, armados juntos en una escena que ninguna de las tres fotos mostraba por sí sola.
Cada referencia cumple una función
El prompt es donde asignas la función: "<<<image_1>>> is the man, keep his coat and stubble" es lo que mantiene esa cara y ese vestuario intactos en lugar de que el modelo los promedie con las demás referencias.
Sonido generado con la escena armada
generate_audio agrega ambiente, efectos y diálogo en la misma pasada. Mantén expectativas realistas para un sonido de fondo descrito solo en una frase o dos: puede renderizarse silencioso en la mezcla final en lugar de como una capa dominante.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Di qué es cada referencia numerada (<<< |
reference_image_urls | Sí | Hasta 7 fotos de referencia para personajes, objetos, atuendos o lugares. JPEG o PNG. mínimo 1 elementos · máximo 7 elementos |
reference_video_urls | No | Video de referencia opcional, un solo clip, del que la nueva toma toma el movimiento, la cámara o los personajes; menciónalo en el prompt como <<< |
elements | No | Un sujeto con nombre para ejecuciones en 4K: dale un nombre, una descripción de una línea y de 2 a 4 fotos de la misma persona u objeto (las muestras de voz de 5 a 30 segundos s… máximo 1 elementos |
aspect_ratio | No | 16:9, 9:16 o 1:1. Elígela antes de escribir la toma para que la composición encaje. |
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: |
keep_original_audio | No | Conserva el sonido propio del video de referencia en el resultado. Activo por defecto; solo cuenta cuando das un video de referencia. 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 (no es garantía estricta). multi deja que el modelo divida la escena en varias tomas por su cuenta. |
multi_prompt | No | La lista de tomas para |
Precios
Se cobra por segundo de salida. La tarifa depende de la resolución, de si el audio nativo está activado y de si das un video de referencia.
| Especificación | Precio |
|---|---|
| $0.0672 / segundo |
| $0.0896 / segundo |
| $0.419 / segundo |
| $0.0896 / segundo |
| $0.112 / segundo |
| $0.419 / segundo |
| $0.1008 / segundo |
| $0.1344 / segundo |
Casos de uso
Pon a una persona en un lugar donde nunca fue fotografiada
Dale a una cara su propia referencia y a un lugar la suya, y describe la acción que los junta: el tipo de toma que una sola foto de cualquiera de los dos no podría dar por sí sola.
Mantén un accesorio o un atuendo consistente entre tomas
Referencia un objeto específico (una joya, un auto, un atuendo distintivo) junto con una referencia de personaje, y aparecerá de forma correcta en lugar de volverse a dibujar ligeramente distinto en cada corrida.
Construye una escena alrededor de tres elementos planeados
Cuando una toma depende de una persona específica, un escenario específico y un objeto específico apareciendo todos juntos (como una carta, una habitación y su lector), las referencias te dejan fijar los tres en lugar de describirlos desde cero en prosa.
Guía de prompts y consejos prácticos
Numera cada referencia y nombra su función
Escribe "<<<image_1>>> is X, keep Y" para cada referencia en orden. Este es el factor más grande para que una referencia se mantenga limpia o termine mezclada con las demás.
Usa tres o cuatro fotos claras en lugar de siete superpuestas
Más referencias no son automáticamente mejores. Un puñado de fotos claras y distintas (una para la cara, una para el atuendo, una para la habitación) sostiene mejor la identidad que siete fotos que se superponen en lo que muestran.
Describe el sonido como una capa de fondo
Cuando pides ambiente como lluvia o ruedas de tren junto con diálogo, espera que quede bajo en la mezcla. Si el ambiente necesita ser prominente, dilo explícitamente en lugar de listarlo brevemente junto al diálogo.
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/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"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.












