Introducción
Kling 2.6 Motion Control copia los movimientos, expresiones y gestos de un video guía sobre un personaje a partir de una foto fija. Dale una sola foto clara de la persona y un clip de 3 a 30 segundos que muestre la actuación, y devuelve un video silencioso en 720p o 1080p que dura exactamente lo mismo que el clip guía.
Elige un modo de Kling 2.6 según tu material de partida
| Lo que tienes al empezar | Modo |
|---|---|
| una escena escrita | Kling 2.6 Texto a video |
| una imagen inicial ya aprobada | Kling 2.6 Imagen a video |
| un clip guía y una foto del personaje | Kling 2.6 Motion Control |
Funciones y aspectos destacados
La propia foto del personaje gana en todo lo que el clip guía no dicta
En nuestra prueba, una rutina de hip-hop bailada por una intérprete se mapeó sobre un hombre distinto con un traje azul marino de tres piezas: los movimientos coincidieron paso a paso, y su traje, sus mocasines, su cara y el loft de concreto de su propia foto se mantuvieron, en lugar del fondo de estudio liso del clip guía.
Salida silenciosa, duración fijada por el clip guía
Este endpoint no tiene campo de audio: el resultado renderiza en silencio, y tampoco tiene campo de duración, ya que la salida siempre iguala la duración del clip guía, de 3 a 30 segundos.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | No | Opcional. Úsalo solo para lo que el clip guía no muestra ya: el escenario a mantener, un detalle del atuendo, cualquier cosa que quieras que se mantenga constante. máximo 2500 caracteres |
image_url | Sí | El personaje a animar: una sola foto clara, de cuerpo completo o medio, de la persona. Solo JPEG o PNG. |
video_url | Sí | Clip guía, de 3 a 30 segundos: los movimientos, expresiones y gestos a copiar. El resultado dura exactamente lo mismo que este clip y no tiene audio. |
resolution | No | 720p o 1080p. Los niveles más altos cuestan más por segundo. |
Precios
Se cobra por segundo de la duración del clip guía: la salida dura exactamente lo mismo que tu video de entrada.
| Especificación | Precio |
|---|---|
| $0.069 / segundo |
| $0.112 / segundo |
Casos de uso
Reutilizar una actuación en varios personajes
Filma o genera un solo clip guía una vez, y luego córrelo contra distintas fotos de personajes para reasignar la misma rutina, caminata o gesto sin volver a animarlo desde cero cada vez.
Agregar movimiento a un diseño de personaje fijo
Da vida a un personaje que ya diseñaste o generaste con una actuación existente, cuando necesitas que el movimiento se vea deliberado y no improvisado.
Guía de prompts y consejos prácticos
Di qué mantener, no qué copiar
El clip guía ya lleva los movimientos, expresiones y gestos; el campo del prompt es para lo que no puede mostrar, casi siempre qué escenario mantener: la propia habitación del personaje, en lugar de la del clip guía.
Iguala el encuadre entre el clip guía y la foto
Nuestra prueba combinó un clip guía de cuerpo completo con una foto de personaje de cuerpo completo. Un desajuste marcado de encuadre entre ambos (una foto de medio cuerpo guiada por un clip de cuerpo completo, por ejemplo) es el tipo de entrada que vale la pena probar primero en baja resolución.
Comprueba que ambas entradas sean lo bastante anchas
Tanto la foto del personaje como el clip guía necesitan unos 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 hayas pagado por él. Comprueba ambas dimensiones en el clip guía, ya que un video puede pasar en ancho y aun así fallar en alto si se grabó con un encuadre poco habitual.
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/2.6/character-animation",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
