Introducción
Kling 4.0 Referencia a video arma un clip nuevo a partir de lo que subes: hasta 10 imágenes de referencia para personas, objetos y lugares, hasta 5 videos de referencia (30 segundos en total) para el movimiento, la cámara y el ritmo, y hasta 3 clips de audio para una voz o un sonido. Nombra cada uno en el prompt como @Image1, @Image2, @Video1 o @Audio1, numerados en el orden en que los subiste. Los clips duran de 3 a 30 segundos a 720p o 1080p, con una pista de sonido estéreo.
Elige un modo de Kling 4.0 según el material de partida
| Lo que tienes al inicio | Modo |
|---|---|
| una escena o guion escrito | Kling 4.0 Texto a video |
| un cuadro de apertura, y opcionalmente un cuadro de cierre y cuadros intermedios | Kling 4.0 Imagen a video |
| fotos, clips o muestras de voz para armar el reparto | Kling 4.0 Referencia a video (estás aquí) |
Funciones y aspectos destacados
Imágenes, videos y voces en una sola solicitud
Kling 4.0 acepta los tres tipos de referencia juntos. Las imágenes definen quién y qué aparece, los videos definen cómo se mueven la cámara y el sujeto, y los clips de audio definen cómo suena alguien.
Nombra cada referencia en el prompt
Escribe @Image1, @Image2 y así sucesivamente en el orden de subida, y di qué es cada una. En nuestro ejemplo del remolque, “@Image1 es la mujer, @Image2 es el remolque cromado” bastó para poner a esa mujer frente a ese remolque.
Toma un movimiento de cámara de un clip
Un video de referencia transmite su movimiento y su ritmo. Activa keep_original_audio para conservar el sonido propio de ese clip en lugar de generar audio nuevo. Los segundos propios del video de referencia también se cobran, a una tarifa más baja que los segundos de salida.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Di qué es cada referencia y qué hace la toma con ella. Escribe @Image1, @Image2 para imágenes, @Video1 para videos y @Audio1 para clips de audio, numerados en el orden de subida. mínimo 1 caracteres |
reference_image_urls | No | Hasta 10 imágenes de personas, objetos, vestuarios o lugares, citadas como @Image1, @Image2 y así sucesivamente. No cambian el precio. mínimo 1 elementos · máximo 10 elementos |
reference_video_urls | No | Hasta 5 videos, 30 segundos en total, para el movimiento, la cámara y el ritmo, citados como @Video1, @Video2. mínimo 1 elementos · máximo 5 elementos |
reference_audio_urls | No | Hasta 3 clips de audio de 5 a 30 segundos cada uno, para una voz o un sonido, citados como @Audio1, @Audio2. Escribe las palabras habladas en el prompt. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (por defecto) sigue las imágenes o el video de referencia; 16:9, 9:16, 1:1 o 21:9 lo fijan tú. No cambia el precio. |
resolution | No | 720p o 1080p (por defecto 720p). 1080p cuesta más por segundo. |
keep_original_audio | No | Desactivado por defecto. Activado conserva el sonido propio del video de referencia en lugar de generar una pista nueva; solo importa cuando das un video de referencia. Valor predeterminado: |
duration_seconds | No | Número entero de segundos, de 3 a 30 (por defecto 5). Define el precio. |
Precios
Se cobra por segundo de salida, más los segundos de cualquier video de referencia (cada clip redondeado al segundo entero) a una tarifa por segundo más baja. 1080p cuesta más por segundo que 720p. Las imágenes de referencia y los clips de audio no cambian el precio. Una solicitud rechazada o fallida no se cobra.
| Especificación | Precio |
|---|---|
| $0.216 / segundo |
| $0.324 / segundo |
Casos de uso
Pon a una persona en un lugar donde nunca fue fotografiada
Un retrato más una foto de un lugar se convierte en una escena de esa persona allí, con la acción que describes.
Mantén consistente un objeto o un vehículo
Dale a un auto, una motocicleta o un vestuario su propia imagen de referencia para que se vea igual en cada clip.
Iguala una voz
Añade una muestra de voz de 5 a 30 segundos como @Audio1 y escribe la línea entre comillas; la frase hablada sigue esa voz.
Guía de prompts y consejos prácticos
Abre con la lista del reparto
Empieza con una frase por referencia —“@Image1 es el hombre, @Image2 es la motocicleta”— y luego describe la toma.
Pocas referencias claras valen más que muchas parecidas
Una foto clara por persona u objeto funciona mejor que varias casi idénticas que el modelo tiene que promediar.
Deja aspect_ratio en auto
En auto, el clip sigue la forma de tus referencias; ajústalo solo cuando necesites un encuadre específico.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.










