Introducción
Kling 3.0 Motion Control toma una sola foto clara de un personaje (image_url) y un clip guía (video_url, de 3 a 30 segundos) y vuelve a reproducir los movimientos, expresiones y gestos de la mano del clip guía sobre ese personaje, manteniendo su cara, atuendo y escenario de la foto. La salida dura exactamente lo mismo que el clip guía y se cobra según esa duración, no según una que elijas. prompt es opcional: úsalo para lo que el clip guía no muestra, como el escenario o el look.
Elige un modo de Kling 3.0 según tu material de partida
| Lo que tienes al empezar | Modo |
|---|---|
| una escena o guion escrito | Kling 3.0 Texto a video |
| un cuadro inicial, y opcionalmente uno final | Kling 3.0 Imagen a video |
| una foto de personaje y un clip guía | Kling 3.0 Motion Control (estás aquí) |
Funciones y aspectos destacados
Una foto, un clip guía, la misma actuación dos veces
Graba o licencia un solo clip guía (un baile, una caminata, un gesto) y córrelo por tantas fotos de personajes como necesites. En nuestra prueba, la rutina del mismo clip guía volvió igualada momento a momento en dos personajes distintos, cada uno manteniendo su propia cara, ropa y fondo.
El resultado dura lo mismo que el clip guía
No hay campo de duración que fijar: la longitud de salida siempre iguala al clip guía, de 3 a 30 segundos, y el cobro sigue esa misma duración.
720p o 1080p
Motion Control no llega a 4K. La resolución cambia el precio de la misma forma que en los otros endpoints de Kling 3.0.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | No | Opcional. Úsalo solo para lo que el clip guía no muestra: el escenario, el look, cualquier cosa que agregar. máximo 2500 caracteres |
negative_prompt | No | Lo que no quieres en el clip (objetos, estilos o movimientos), hasta 2500 caracteres. Opcional; no cambia el costo. máximo 2500 caracteres |
image_url | Sí | El personaje a animar: una sola foto clara, de cuerpo completo o medio, de la persona. |
video_url | Sí | Clip guía, de 3 a 30 segundos: los movimientos, expresiones y gestos a copiar. El resultado dura lo mismo que este clip y se cobra según esa duración. |
resolution | No | 720p o 1080p. El nivel más alto cuesta más por segundo. |
keep_original_audio | No | Conserva el sonido propio del clip guía en el resultado. Activo por defecto. Valor predeterminado: |
character_orientation | No | Hacia dónde mira el personaje en el resultado: video (por defecto) sigue a la persona del clip guía; image sigue a la persona de tu foto. |
shot_type | No | Cómo se planifican las tomas: customize (por defecto) se atiene a lo que envías; intelligent deja que el modelo las planifique por su cuenta. No cambia el costo. |
Precios
Se cobra según la duración del clip guía (video_url), redondeada al segundo entero siguiente, de 3 a 30 segundos, no según una duración que fijes. La resolución cambia la tarifa.
| Especificación | Precio |
|---|---|
| $0.1008 / segundo |
| $0.1344 / segundo |
Casos de uso
Reutiliza una actuación en varios personajes
Coreografía o licencia un solo clip guía una vez, y luego aplícalo a cada foto de personaje de una serie (una rutina de baile, el gesto de un presentador de producto, un saludo recurrente) sin volver a filmar el movimiento cada vez.
Dale a una foto fija de personaje movimiento real y dirigido
En lugar de describir el movimiento con palabras y esperar un gesto específico, Motion Control te deja mostrar el movimiento exacto una vez, como clip guía, y aplicarlo con precisión.
Localiza una actuación a un escenario nuevo
Usa el prompt opcional para ubicar al personaje en un lugar distinto al fondo propio del clip guía, mientras el movimiento en sí se mantiene idéntico.
Guía de prompts y consejos prácticos
Deja que el clip guía lleve el movimiento
El prompt no necesita describir ningún movimiento: el clip guía ya lo aporta. Úsalo solo para lo que el clip no muestra, como la habitación, un detalle del vestuario o el ánimo.
Mantén la foto del personaje clara y de un solo sujeto
Una foto clara, de cuerpo completo o medio, de una sola persona, bien iluminada y sin obstrucciones, le da a Motion Control la coincidencia más clara. Una foto con el personaje parcialmente oculto o en un ángulo inusual deja más cosas que el modelo tiene que adivinar.
Verifica que ambas entradas sean lo bastante anchas
Tanto la foto del personaje como el clip guía necesitan aproximadamente 720 píxeles o más en cada lado; un clip guía por debajo de eso se rechaza antes de que empiece el trabajo, no después de que ya lo pagaste.
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/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.












