Passer au contenu

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

Note d'itinéraire : l'URL publique indique toujours 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.
Utilisez le point de terminaison de compatibilité uniquement si vous expédiez déjà la vidéo authentifiée existante API.

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.

720p
20 crédits / seconde
1080p
27 crédits / seconde

Crédits, modèles et statut