Skip to main content
POST

Autorisation

string
requis
Tous les points de terminaison API nécessitent une authentification par Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéoModèles pris en charge :
  • kling-video-o1 — Kling Video O1 (amélioré par reasoning, qualité maximale)
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Prompt textuel positifLe prompt ne doit pas dépasser 2 500 caractères.Permet de référencer les images de image_urls via la syntaxe <<<image_N>>>, où N commence à 1.Exemple : "Make the person in <<<image_1>>> wave at the camera"
Si des images sont fournies mais que le prompt ne contient aucune référence <<<image_N>>>, le système ajoute automatiquement <<<image_1>>> au début du prompt.
string
défaut:"std"
Mode de générationOptions :
  • std — mode standard (720P)
  • pro — mode professionnel (1080P)
Par défaut : std
integer
défaut:"5"
Durée de la vidéo (en secondes)Options : 5 ou 10Par défaut : 5
string
défaut:"16:9"
Format d’image de la vidéoOptions :
  • 16:9 — paysage
  • 9:16 — portrait
  • 1:1 — carré
Par défaut : 16:9
array<url>
Tableau d’URL d’images pour le référencement d’imagesRéférencez les images correspondantes dans le prompt via la syntaxe <<<image_N>>> (N commence à 1)Exemple : ["https://example.png"]
  • Les URL d’images doivent être publiquement accessibles, sans protection anti-hotlink
  • En mode image-to-video, aspect_ratio peut être remplacé par le rapport réel de l’image
  • Jusqu’à deux images. Le premier élément du tableau est l’image de début, le second l’image de fin
array<object>
Tableau d’images avec rôles, recommandé pour l’image-to-video.Format de chaque élément : { "url": "...", "role": "..." }
  • first_frame : première image
  • last_frame : dernière image
  • reference : image de référence
  • image_urls et image_with_roles sont mutuellement exclusifs, ne les transmettez pas en même temps.
  • Lorsque plus de 2 images sont fournies, la définition des images de début et de fin n’est pas prise en charge.
array
Liste de vidéos de référence (basée sur URL), jusqu’à 1 vidéo.Utilisez refer_type pour distinguer les types :
  • base : vidéo à éditer (par défaut)
  • feature : vidéo de référence de caractéristiques
Utilisez keep_original_sound pour contrôler la conservation ou non de l’audio d’origine :
  • no : ne pas conserver (par défaut)
  • yes : conserver le son d’origine
Format de la requête :
  • video_url ne peut pas être vide, et l’URL de la vidéo doit être accessible
  • Lorsque refer_type=base :
    • Les images de début/fin ne peuvent pas être définies
    • La vidéo de référence doit durer 3 à 10 secondes
    • La durée de la vidéo générée suit celle de la vidéo téléversée
  • Lorsque refer_type=feature et que video_url n’est pas vide :
    • image_urls ne peut contenir qu’une image de première image
  • Exigences vidéo : MP4/MOV uniquement ; durée d’au moins 3 secondes ; résolution 720–2160 px ; fréquence d’images 24–60 fps (la sortie est de 24 fps) ; taille maximale 200 Mo

Syntaxe de référence d’image

Le modèle Video O1 utilise la syntaxe <<<image_N>>> pour référencer des images dans les prompts, offrant une expérience unifiée text-to-video / image-to-video :
Référence automatique : si image_urls est fourni mais que le prompt ne contient aucune référence <<<image_N>>>, le système ajoute automatiquement <<<image_1>>> au début du prompt.

Réponse

integer
Code de statut de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Cas d’usage

Cas 1 : Texte vers vidéo (qualité maximale)

Cas 2 : Référence d’image (image unique)

Cas 3 : Références à plusieurs images

Cas 4 : Image fournie sans référence explicite (ajoutée automatiquement)

Le système ajoute automatiquement <<<image_1>>> au début du prompt, ce qui équivaut à "<<<image_1>>>The person slowly turns and smiles".
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats.