Processus de demande
Pour utiliser l’API de génération de mouvement Kling, commencez par obtenir votre jeton API sur le tableau de bord Ace Data Cloud pour le garder en réserve.
Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle.
Un jeton API suffit pour appeler tous les services de la plateforme, sans avoir à en demander un pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; si le quota est insuffisant, vous pouvez recharger le solde général sur le tableau de bord.
📘 Documentation complète : API de génération de mouvement Kling →
Utilisation de base
Tout d’abord, comprenons la méthode d’utilisation de base, qui consiste à entrer un mot-cléprompt, une image de référence image_url et un lien vidéo de référence video_url, pour obtenir le résultat traité. Ensuite, nous devons également entrer le modèle mode, qui comprend principalement les modèles std et pro, comme indiqué ci-dessous :
accept: le format de réponse souhaité, ici rempli avecapplication/json, c’est-à-dire au format JSON.authorization: la clé pour appeler l’API, que vous pouvez sélectionner directement après la demande.
image_url: URL de l’image de référence pour l’apparence du personnage. Prend en charge JPG/JPEG/PNG, fichier ≤50MB, largeur et hauteur ≥300px, rapport d’aspect 1:2.5 à 2.5:1 ; le personnage doit être clairement visible en haut du corps ou en entier avec la tête.video_url: URL de la vidéo de référence pour le mouvement. Prend en charge MP4/MOV, fichier ≤100MB, largeur et hauteur entre 340 et 3850px, d’une durée d’au moins 3 secondes ;character_orientation=imagemaximum 10 secondes,character_orientation=videomaximum 30 secondes. Il est recommandé d’utiliser une vidéo continue en un seul plan où le personnage reste toujours dans le cadre.mode: le mode de génération de la vidéo, principalement le mode standardstdet le mode rapidepro.keep_original_sound: option pour conserver le son original de la vidéo, valeurs énumérées : yes, no.character_orientation: orientation du personnage dans la vidéo générée, pouvant être alignée avec l’image ou la vidéo, valeurs énumérées : image, video.prompt: mot-clé.callback_url: URL pour recevoir le résultat.async: optionnel, si défini surtrue, l’interface renvoie immédiatementtask_id, sans avoir besoin de fournircallback_url, puis le résultat peut être obtenu par polling via l’interface de requête de tâche correspondante.
success, l’état de la tâche de génération de vidéo à ce moment.task_id, l’ID de la tâche de génération de vidéo à ce moment.video_id, l’ID de la vidéo générée à ce moment.video_url, le lien de la vidéo générée à ce moment.duration, la durée de la vidéo générée à ce moment.state, l’état de la tâche de génération de vidéo à ce moment.
data pour obtenir la vidéo Kling générée.
De plus, si vous souhaitez générer le code d’intégration correspondant, vous pouvez le copier directement, par exemple, le code CURL est comme suit :
Rappel asynchrone
Étant donné que le temps de génération de l’API de génération de mouvement Kling est relativement long, environ 1 à 2 minutes, si l’API ne répond pas pendant longtemps, la requête HTTP maintiendra la connexion, entraînant une consommation supplémentaire de ressources système. Par conséquent, cette API propose également un support de rappel asynchrone. Le processus global est le suivant : lorsque le client initie une demande, il spécifie un champcallback_url supplémentaire. Après que le client ait lancé la demande API, l’API renverra immédiatement un résultat contenant un champ task_id, représentant l’ID de la tâche actuelle. Lorsque la tâche est terminée, le résultat de la vidéo générée sera envoyé au callback_url spécifié par le client sous forme de POST JSON, incluant également le champ task_id, permettant ainsi de lier le résultat de la tâche par ID.
Voyons comment procéder à travers un exemple.
Tout d’abord, le rappel Webhook est un service capable de recevoir des requêtes HTTP, et le développeur doit le remplacer par l’URL de son propre serveur HTTP. Pour des raisons de démonstration, nous utiliserons un site d’exemple Webhook public https://webhook.site/, en ouvrant ce site pour obtenir une URL Webhook, comme illustré ci-dessous :
Copiez cette URL pour l’utiliser comme Webhook, l’exemple ici est https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3.
Ensuite, nous pouvons définir le champ callback_url sur l’URL Webhook ci-dessus, tout en remplissant les paramètres correspondants, comme illustré ci-dessous :
https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3, comme illustré ci-dessous :
Le contenu est le suivant :
task_id dans le résultat, les autres champs sont similaires à ceux mentionnés précédemment, et ce champ permet d’associer les tâches.
Gestion des erreurs
Lors de l’appel de l’API, si une erreur se produit, l’API renverra le code d’erreur et les informations correspondantes. Par exemple :400 token_mismatched: Mauvaise requête, probablement en raison de paramètres manquants ou invalides.400 api_not_implemented: Mauvaise requête, probablement en raison de paramètres manquants ou invalides.401 invalid_token: Non autorisé, jeton d’autorisation invalide ou manquant.429 too_many_requests: Trop de requêtes, vous avez dépassé la limite de taux.500 api_error: Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.