> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Documentation de l'API Midjourney Videos > Midjourney generation 集成指南 - XHuoAPI Cet article présentera une documentation sur l'intégration de l'API Midjourney Videos, qui permet de générer des vidéos officielles de Midjourney en entrant des paramètres personnalisés. ## Processus de demande Pour utiliser l'API, vous devez d'abord vous rendre sur la page [Midjourney Videos API](https://api.xhuoapi.ai/documents/midjourney-videos) pour demander le service correspondant. Une fois sur la page, cliquez sur le bouton « Acquire », comme indiqué dans l'image ci-dessous : ![](https://cdn.xhuoapi.ai/q6ytrc.png) 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 vous être connecté ou inscrit, vous serez automatiquement renvoyé à la page actuelle. Lors de la première demande, un quota gratuit sera offert, vous permettant d'utiliser cette API gratuitement. ## Utilisation de base Tout d'abord, comprenons la méthode d'utilisation de base, qui consiste à entrer le mot-clé `prompt`, l'action `action`, et un tableau d'images de référence pour la première et la dernière image `image_url`, afin d'obtenir le résultat traité. Vous devez d'abord transmettre un champ `action`, dont la valeur est `generate`. Cela comprend principalement deux types d'actions : générer une vidéo (`generate`), étendre une vidéo (`extend`), les détails sont les suivants :

Nous pouvons voir ici que nous avons défini les en-têtes de la requête, y compris : * `accept` : le format de réponse souhaité, ici rempli avec `application/json`, c'est-à-dire au format JSON. * `authorization` : la clé d'API pour appeler l'API, que vous pouvez sélectionner directement après la demande. De plus, nous avons défini le corps de la requête, y compris : * `image_url` : le lien de l'image de référence pour la première image de la vidéo générée. * `end_image_url` : optionnel, spécifie l'image de référence pour la dernière image de la vidéo générée. * `video_id` : nécessaire pour étendre la vidéo, spécifiez l'ID de la vidéo. * `video_index` : nécessaire pour spécifier quelle vidéo parmi celles désignées par `video_id`, l'index commence à 0, la valeur par défaut est 0. * `action` : l'action de cette tâche de génération de vidéo, comprenant principalement deux actions : générer une vidéo (`generate`), étendre une vidéo (`extend`). * `prompt` : le mot-clé. * `mode` : le mode de vitesse de génération de vidéo, par défaut rapide. * `resolution` : la clarté de la vidéo, par défaut 720p. * `loop` : si la vidéo générée doit être en boucle, par défaut faux. * `callback_url` : l'URL pour laquelle les résultats doivent être rappelés. Après avoir fait votre sélection, vous pouvez voir que le code correspondant a également été généré à droite, comme indiqué dans l'image ci-dessous :

Cliquez sur le bouton « Try » pour effectuer un test, comme indiqué ci-dessus, et nous avons obtenu le résultat suivant : ```json theme={null} { "image_url": "https://storage.fonedis.cc/upload_1751816808164156352.png", "image_width": 560, "image_height": 688, "progress": 100, "video_id": "1751816807896311", "video_urls": [ "https://storage.fonedis.cc//video/1c67c36c-8177-4f19-ad72-1dc1567265a6/0_0.mp4", "https://storage.fonedis.cc//video/1c67c36c-8177-4f19-ad72-1dc1567265a6/0_1.mp4", "https://storage.fonedis.cc//video/1c67c36c-8177-4f19-ad72-1dc1567265a6/0_2.mp4", "https://storage.fonedis.cc//video/1c67c36c-8177-4f19-ad72-1dc1567265a6/0_3.mp4" ], "task_id": "037955e0-deee-4050-baa8-1416300d67e2", "success": true } ``` Le résultat de retour contient plusieurs champs, décrits comme suit : * `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. * `image_url`, l'image de couverture de la tâche de génération de vidéo à ce moment. * `image_width`, la largeur de l'image de couverture de la tâche de génération de vidéo à ce moment. * `image_height`, la hauteur de l'image de couverture de la tâche de génération de vidéo à ce moment. * `video_id`, l'ID de la vidéo de la tâche de génération de vidéo à ce moment. * `video_urls`, un tableau de liens vidéo de la tâche de génération de vidéo à ce moment. Nous pouvons voir que nous avons obtenu des informations vidéo satisfaisantes, nous n'avons qu'à récupérer la vidéo Midjourney générée à partir de l'adresse du lien vidéo dans `video_urls`. 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 le suivant : ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/videos' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "prompt": "A cat sitting on a table", "image_url": "https://cdn.xhuoapi.ai/jgo1cw.jpg" }' ``` ## Fonctionnalité d'extension de vidéo Si vous souhaitez continuer à générer une vidéo Kling déjà créée, vous pouvez définir le paramètre `action` sur `extend`, et entrer l'ID de la vidéo que vous souhaitez continuer à générer. L'ID de la vidéo peut être obtenu selon l'utilisation de base. À ce moment-là, vous pouvez voir que l'ID de la vidéo ci-dessus est : ``` "video_id": "1751816807896311" ``` > Remarque : ici, l'`video_id` dans la vidéo est l'ID de la vidéo après génération. Si vous ne savez pas comment générer une vidéo, vous pouvez vous référer à l'utilisation de base ci-dessus pour générer une vidéo. Ensuite, vous devez remplir les mots-clés nécessaires pour personnaliser la génération de la vidéo que vous souhaitez étendre, vous pouvez spécifier les éléments suivants : * `video_index` : sélectionnez l'index de la vidéo à étendre, cet index provient des `video_urls` générés ci-dessus, l'index commence à 0, la valeur par défaut est 0. * `video_id` : l'ID de la vidéo spécifiée pour l'extension. * `action` : l'action de cette extension de vidéo, qui est `extend`. * `prompt` : le mot-clé. Un exemple de remplissage est le suivant :

Après avoir rempli, le code suivant a été généré automatiquement :

Le code Python correspondant : ```python theme={null} import requests url = "https://api.xhuoapi.ai/v1/midjourney/videos" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "extend", "prompt": "A cat sitting on a table", "video_id": "1751816807896311", "video_index": 1 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` Cliquez sur exécuter, et vous verrez un résultat, comme suit : ```json theme={null} { "image_url": "https://storage.fonedis.cc/upload_1751817471047011172.png", "image_width": 560, "image_height": 688, "progress": 100, "video_id": "1751818094559027", "video_urls": [ "https://storage.fonedis.cc//video/a4bd2f43-b925-462d-9725-8aef98403133/0_0.mp4", "https://storage.fonedis.cc//video/a4bd2f43-b925-462d-9725-8aef98403133/0_1.mp4", "https://storage.fonedis.cc//video/a4bd2f43-b925-462d-9725-8aef98403133/0_2.mp4", "https://storage.fonedis.cc//video/a4bd2f43-b925-462d-9725-8aef98403133/0_3.mp4" ], "task_id": "da3bdcd0-9c21-4b40-877a-2c36e5f479e5", "success": true } ``` On peut voir que le contenu du résultat est cohérent avec le texte précédent, ce qui permet de réaliser la fonction d'extension vidéo. ## Callback asynchrone Étant donné que le temps de génération de l'API Midjourney Videos est relativement long, environ 1 à 2 minutes, si l'API ne répond pas pendant une longue période, la requête HTTP maintiendra la connexion, entraînant une consommation supplémentaire de ressources système. C'est pourquoi cette API propose également un support de callback asynchrone. Le processus global est le suivant : lorsque le client initie une requête, il spécifie un champ `callback_url` supplémentaire. Après que le client a lancé la requête API, l'API renverra immédiatement un résultat contenant un champ d'information `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 relier le résultat de la tâche par ID. Voyons comment procéder à travers un exemple. Tout d'abord, le callback Webhook est un service capable de recevoir des requêtes HTTP, les développeurs doivent le remplacer par l'URL de leur propre serveur HTTP. Ici, pour des raisons de démonstration, nous utilisons un site Web de Webhook public [https://webhook.site/](https://webhook.site/), en ouvrant ce site, vous obtiendrez une URL Webhook, comme illustré ci-dessous :

Copiez cette URL, elle peut être utilisée comme Webhook, l'exemple ici est `https://webhook.site/556e6971-b41f-4fa8-9151-6e91acd0399f`. Ensuite, nous pouvons définir le champ `callback_url` sur l'URL Webhook ci-dessus, tout en remplissant les paramètres correspondants, le contenu spécifique est illustré ci-dessous :

En cliquant sur exécuter, vous constaterez que vous obtiendrez immédiatement un résultat, comme suit : ``` { "task_id": "b726a27a-f379-4d91-b569-cfe4b7b299ee" } ``` Après un moment, nous pouvons observer le résultat de la vidéo générée sur `https://webhook.site/556e6971-b41f-4fa8-9151-6e91acd0399f`, comme illustré ci-dessous :

Le contenu est le suivant : ```json theme={null} { "image_url": "https://storage.fonedis.cc/upload_1751818513244368774.png", "image_width": 560, "image_height": 688, "progress": 100, "video_id": "1751818512924054", "video_urls": [ "https://storage.fonedis.cc//video/9ff3783e-bcf6-4f11-b738-09aa52318e6e/0_0.mp4", "https://storage.fonedis.cc//video/9ff3783e-bcf6-4f11-b738-09aa52318e6e/0_1.mp4", "https://storage.fonedis.cc//video/9ff3783e-bcf6-4f11-b738-09aa52318e6e/0_2.mp4", "https://storage.fonedis.cc//video/9ff3783e-bcf6-4f11-b738-09aa52318e6e/0_3.mp4" ], "task_id": "b726a27a-f379-4d91-b569-cfe4b7b299ee", "success": true } ``` On peut voir qu'il y a un champ `task_id` dans le résultat, les autres champs sont similaires à ceux du texte précédent, permettant de relier la tâche via ce champ. ## 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. ### Exemple de réponse d'erreur ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "échec de la récupération" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Conclusion Grâce à ce document, vous avez compris comment utiliser l'API Midjourney Videos pour générer des vidéos en entrant des mots-clés et une image de référence de la première image. Nous espérons que ce document vous aidera à mieux intégrer et utiliser cette API. Si vous avez des questions, n'hésitez pas à contacter notre équipe de support technique.