Introducción
Kling 4.0 Flash referencia a video genera una escena nueva a 720p con un prompt obligatorio y las referencias que aportes. Añade hasta 10 imágenes y hasta 5 clips de video cuya duración total sea de 20 segundos. Nombra las imágenes como @Image1 y los videos como @Video1, siguiendo la numeración según el orden de subida.
Explica en el prompt qué aporta cada referencia. En el ejemplo del desierto, una imagen identifica al sujeto y dos videos orientan el movimiento de cámara en una escena al anochecer. Los clips nuevos duran de 3 a 20 segundos enteros, con 5 segundos por defecto, e incluyen audio sincronizado; keep_original_audio permite conservar el sonido de un video de referencia. No se admiten archivos de audio como referencia.
Funciones y aspectos destacados
- Asigna hasta 10 imágenes de referencia a sujetos, objetos o detalles de la escena dentro del prompt.
- Orienta el movimiento y el encuadre con hasta 5 videos que no superen 20 segundos en total.
- Conecta la descripción de la escena con los archivos enviados mediante etiquetas @Image1 y @Video1.
- Genera un resultado a 720p de 3–20 segundos con audio o conserva el sonido del video de referencia mediante
keep_original_audio. - Sigue el encuadre de entrada con auto o elige 16:9, 9:16, 1:1 o 21:9.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Instrucciones de escena obligatorias, sin texto predefinido; asigna funciones a @Image1, @Image2, @Video1 y las siguientes entradas. La redacción del prompt no suma cargos aparte. mínimo 1 caracteres |
reference_image_urls | No | Envía hasta 10 URL de imágenes y nómbralas @Image1, @Image2 y así sucesivamente en el orden de subida. Orientan la escena sin modificar el precio. mínimo 1 elementos · máximo 10 elementos |
reference_video_urls | No | Envía hasta 5 URL de videos que sumen 20 segundos y nómbralos @Video1, @Video2 y así sucesivamente. mínimo 1 elementos · máximo 5 elementos |
aspect_ratio | No | Selecciona auto para seguir las referencias o elige 16:9, 9:16, 1:1 o 21:9. La forma del cuadro no afecta la tarifa por segundo ni suma cargos. |
keep_original_audio | No | Usa true para conservar el sonido del video de referencia o false para generar una pista nueva; se aplica cuando envías un video de referencia. Valor predeterminado: |
duration_seconds | No | La duración de salida admite segundos enteros de 3 a 20 y usa 5 segundos por defecto. Modifica el cobro total a través de la duración de salida facturada. |
Precios
$0.113 / segundo
La generación con referencias se cobra por segundo de salida. Incluir un video de referencia aplica una tarifa por segundo más alta a la duración de salida; la duración del video de referencia no se cobra aparte. Las imágenes de referencia, la redacción del prompt, la relación de aspecto y keep_original_audio no añaden cargos independientes. Las solicitudes rechazadas por la moderación de Kling quedan sin cargo.
Casos de uso
- Lleva al sujeto de una imagen a una escena desértica para redes, guiada por clips breves de movimiento.
- Explora una combinación de personaje y lugar con imágenes de referencia nombradas por separado.
- Crea varios bocetos breves alrededor de un movimiento de cámara elegido para revisar contenido.
Guía de prompts y consejos prácticos
- Define la función de cada imagen, por ejemplo, “@Image1 aporta el sujeto”, antes de describir la nueva escena.
- Explica qué tomar del video, como “usa el acercamiento lento de cámara de @Video1”, para darle un propósito concreto a la referencia.
- Describe el nuevo entorno, por ejemplo, “un desierto tranquilo al anochecer”, para distinguirlo del material de referencia.
- Para un boceto de 3 segundos, pide una acción breve, como “el viajero se detiene junto al letrero”.
- Si vas a generar una pista de sonido nueva, añade una indicación como “Sonido: viento seco y un tren lejano” para orientar el audio incluido.
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/4.0-flash/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"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.
