Documentation Kling Motion Control API
Documents Kling Motion Control API pour les flux de travail d'images et de vidéos animées
Référence du contrôle de mouvement Kling
Documents Kling Motion Control API pour les flux de travail d'images et de vidéos animées
Utilisez ce guide pour intégrer Contrôle de mouvement Kling 2.6 via le UlazAI API.
L'intégration actuelle utilise model_slug="kling_3_0_motion_control" sur
/api/v1/video-studio/generate/, ou le chemin de compatibilité
/api/v1/generate/video/ avec video_model="kling_3_0_motion_control".
Vous envoyez exactement une URL d'image, une URL de vidéo animée, un prompt et un mode qualité 720p ou 1080p.
Points de terminaison principaux
/api/v1/video-studio/generate/
/api/v1/video-studio/status/{job_id}/
/api/v1/generate/video/
Prise en charge actuelle
1 URL d'image + 1 URL de vidéo animée
Sortie 720p ou 1080p
3 à 15 secondes
kling-2-6-motion-control-api-docs, mais le
Le modèle actuel pour les intégrations en direct est kling_3_0_motion_control.
Authentification
Envoyez un jeton au porteur ou une clé API à chaque demande.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Demande canonique
Cette demande s'adresse à /api/v1/video-studio/generate/.
Il s'agit du contrat API préféré pour les nouvelles intégrations.
{
"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
}
Référence du champ
| Champ | Obligatoire | Remarques |
|---|---|---|
model_slug |
Oui | Doit être kling_3_0_motion_control |
prompt |
Oui | 2 500 caractères maximum |
input_image_urls |
Oui | Exactement une URL d'image publique |
input_video_urls |
Oui | Exactement une URL de vidéo animée publique |
character_orientation |
Non | Utiliser video pour suivre l'orientation du clip animé ou image pour conserver le cadrage des caractères téléchargés |
quality_mode |
Oui | Utiliser 720p ou 1080p |
duration_seconds |
Oui | Entier compris entre 3 et 15. La tarification utilise cette durée. |
Demande de compatibilité héritée
Cette demande s'adresse à /api/v1/generate/video/.
Utilisez-le si vous intégrez déjà l’ancienne vidéo authentifiée 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
}
Exemples de réponses
Générer une réponse canonique
{
"success": true,
"job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
"credits_remaining_total": 438
}
L'héritage génère une réponse
{
"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
}
}
Sondage d'état
GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/
Tarifs
La tarification de Motion Control est basée sur la durée.