Control de movimiento Kling API documentos
Documentos de Kling Motion Control API para flujos de trabajo de imagen y vídeo en movimiento
Referencia de control de movimiento Kling
Documentos de Kling Motion Control API para flujos de trabajo de imagen y vídeo en movimiento
Utilice esta guía para integrar Kling 2.6 Control de movimiento a través del UlazAI API.
La integración actual utiliza model_slug="kling_3_0_motion_control" en
/api/v1/video-studio/generate/, o la ruta de compatibilidad
/api/v1/generate/video/ con video_model="kling_3_0_motion_control".
envias exactamente URL de una imagen, URL de un vídeo en movimiento, un prompt y un modo de calidad 720p o 1080p.
Puntos finales principales
/api/v1/video-studio/generate/
/api/v1/video-studio/status/{job_id}/
/api/v1/generate/video/
Soporte actual
1 URL de imagen + 1 URL de vídeo en movimiento
Salida de 720p o 1080p
3 a 15 segundos
kling-2-6-motion-control-api-docs, pero el
El modelo actual de slug para integraciones en vivo es kling_3_0_motion_control.
Autenticación
Envíe un token al portador o una clave API en cada solicitud.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Solicitud canónica
Esta solicitud va a /api/v1/video-studio/generate/.
Es el contrato API preferido para nuevas integraciones.
{
"model_slug": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"input_image_urls": ["https://example.com/character.png"],
"input_video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Referencia de campo
| campo | Requerido | Notas |
|---|---|---|
model_slug |
si | debe ser kling_3_0_motion_control |
prompt |
si | Máximo 2500 caracteres |
input_image_urls |
si | Exactamente una URL de imagen pública |
input_video_urls |
si | Exactamente una URL de vídeo de movimiento público |
character_orientation |
No | uso video para seguir la orientación del clip de movimiento o image para mantener el encuadre del personaje subido |
quality_mode |
si | uso 720p o 1080p |
duration_seconds |
si | Entero de 3 a 15. El precio utiliza esta duración. |
Solicitud de compatibilidad heredada
Esta solicitud va a /api/v1/generate/video/.
Úselo si ya lo integra con el video autenticado anterior API.
{
"video_model": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"source_image_urls": ["https://example.com/character.png"],
"video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Ejemplos de respuesta
Canónica generar respuesta
{
"success": true,
"job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
"credits_remaining_total": 438
}
Respuesta de generación heredada
{
"success": true,
"data": {
"generation_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"generation_type": "video",
"video_model": "kling30_motion",
"mode": "image-to-video",
"status": "processing",
"credits_used": 300
}
}
Encuesta de estado
GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/
Precios
El precio de Motion Control se basa en la duración.