API Kling 3.0 Motion Control

Référence complète de l’API de génération vidéo Kling 3.0 Motion Control de Kuaishou.

Variantes du modèle

Cette API prend en charge une variante du modèle :

Modèle	ID	Description
Kling 3.0 Motion Control	`kling-3.0-motion-control`	Génération vidéo à partir d’une consigne textuelle, d’une image de référence et d’une vidéo de référence

Kling 3.0 Motion Control

Point de terminaison

POST /api/v1/video/task

Paramètres de la requête

Obligatoires

Paramètre	Type	Description
`model_name`	string	Doit être `"kling-3.0-motion-control"`
`prompt`	string	Consigne de génération vidéo, jusqu’à 5000 caractères
`images`	string[]	Exactement une URL d’image de référence. Formats pris en charge : `.jpg`, `.jpeg` et `.png` ; la taille du fichier ne doit pas dépasser 50 Mo. La largeur et la hauteur doivent chacune être d’au moins 300 px, avec un rapport largeur/hauteur de l’image compris entre 1:2.5 et 2.5:1
`videos`	string[]	Exactement une URL de vidéo de référence. Formats pris en charge : `.mp4` et `.mov` ; la taille du fichier ne doit pas dépasser 100 Mo. La largeur et la hauteur doivent chacune être comprises entre 340 et 3850 px, bornes incluses. La durée doit être d’au moins 3 secondes ; le maximum dépend de `character_orientation`
`character_orientation`	string	Obligatoire, sans valeur par défaut. `"image"` : suit l’orientation du personnage dans l’image de référence ; la vidéo de référence doit durer entre 3 et 10 secondes. `"video"` : suit l’orientation du personnage dans la vidéo de référence ; la vidéo de référence doit durer entre 3 et 30 secondes. Les deux intervalles de durée incluent leurs bornes
`resolution`	string	Résolution de sortie : `"720p"` ou `"1080p"`. Obligatoire, sans valeur par défaut

Facultatifs

Paramètre	Type	Description
`keep_original_sound`	boolean	Indique s’il faut conserver le son d’origine de la vidéo de référence. Accepte `true` ou `false` ; la valeur par défaut est `true`

La durée de sortie correspond à celle de la vidéo source. Le paramètre duration n’est pas pris en charge. Le rapport largeur/hauteur de sortie est déterminé par les médias d’entrée, et aspect_ratio n’est pas pris en charge. Le fournisseur en amont n’a pas précisé quelle entrée détermine le rapport largeur/hauteur de sortie ni la règle exacte de sélection.

La facturation repose sur la durée de la vidéo source arrondie à la seconde entière la plus proche et sur la résolution de sortie sélectionnée. Par exemple, 5,4 secondes sont facturées comme 5 secondes, et 5,5 secondes comme 6 secondes.

Exemple de requête

Remplacez les URL des médias de l’exemple par celles de vos propres fichiers respectant les exigences ci-dessus.

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-3.0-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Format de réponse

Réponse initiale

Renvoie un task_id pour les interrogations périodiques :

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Effectuez des interrogations périodiques avec GET /api/v1/video/{task_id} pour vérifier l’état et récupérer la vidéo générée.

Valeurs d’état

submitted : Tâche acceptée et en attente de traitement
processing : Génération vidéo en cours
succeed : Génération vidéo terminée
failed : Échec de la génération vidéo

Bonnes pratiques

Médias de référence : Fournissez exactement une image et une vidéo, en vérifiant leurs formats, tailles de fichier et dimensions avant l’envoi
Orientation : Vérifiez à nouveau la durée de la vidéo de référence lorsque vous modifiez character_orientation, en particulier lorsque vous sélectionnez "image"
Son d’origine : Définissez keep_original_sound sur false pour désactiver la conservation du son d’origine de la vidéo de référence ; si vous omettez ce paramètre, le son est conservé