API Kling 2.6 Motion Control

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

Variantes du modèle

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

Modèle	ID	Description
Kling 2.6 Motion Control	`kling-2.6-motion-control`	Génération vidéo à partir d'un prompt textuel, d'une image de référence et d'une vidéo de référence

Kling 2.6 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-2.6-motion-control"`
`prompt`	string	Prompt 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 MB. La largeur et la hauteur doivent chacune être d'au moins 300 px, avec un rapport d'aspect 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 MB. 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 3-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 3-30 secondes. Les deux plages 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 si le son original de la vidéo de référence doit être conservé. Accepte `true` ou `false` ; la valeur par défaut est `true`

La durée de sortie suit celle de la vidéo source. Le paramètre duration n'est pas pris en charge. Le rapport d'aspect 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 d'aspect 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 d'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-2.6-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 la 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"
  }
}

Interrogez périodiquement 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 original : Définissez keep_original_sound sur false pour ne pas conserver le son original de la vidéo de référence ; si vous omettez ce paramètre, le son est conservé