Skip to main content
Avec l’application croissante de l’IA, divers programmes d’IA sont devenus progressivement courants. L’IA s’est progressivement intégrée dans tous les aspects de la vie professionnelle et personnelle des gens. Les secteurs impliqués dans l’IA sont également de plus en plus nombreux, allant de l’écriture initiale, à l’éducation médicale, jusqu’à la vidéo actuelle. Luma est une plateforme de génération vidéo de haute qualité et professionnelle, où les utilisateurs n’ont qu’à télécharger des matériaux pour générer automatiquement des vidéos de haute qualité selon différents styles et effets. Ce générateur vidéo AI a été développé par des membres d’équipes de sociétés technologiques renommées, avec pour objectif de permettre à chacun de créer facilement d’excellentes vidéos sans outils d’édition complexes. Cependant, Luma n’a pas fourni d’API officielle, AceDataCloud a mis à disposition un ensemble d’API Luma, simulant l’intégration avec l’officiel de Suno, permettant de générer rapidement et facilement les vidéos souhaitées.

​
Demande et utilisation

Pour utiliser l’API de génération de vidéos Luma, commencez par obtenir votre token 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 token 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 vidéos Luma →

​
Utilisation de base

Pour générer une vidéo, vous pouvez entrer n’importe quel texte, par exemple, si je veux générer une vidéo sur des astronautes se déplaçant entre l’espace et un volcan, je peux entrer Astronauts shuttle from space to volcano, comme illustré ci-dessous :

Le code généré est le suivant :

Principaux paramètres de requête :
  • prompt : le mot-clé pour générer la vidéo.
  • aspect_ratio : le rapport hauteur/largeur de la vidéo, par défaut 16:9.
  • end_image_url : optionnel, spécifie la dernière image.
  • enhancement : optionnel, interrupteur d’amélioration de la clarté.
  • loop : si la vidéo doit être en boucle, par défaut false.
  • timeout : optionnel, nombre de secondes avant le timeout.
  • callback_url : adresse de rappel asynchrone.
  • async : optionnel, si défini sur true, l’interface retourne immédiatement task_id, sans avoir besoin de fournir callback_url, puis interrogez le résultat via l’interface de requête de tâche correspondante.
Vous pouvez cliquer sur le bouton « Essayer » pour tester directement l’API, attendez 1 à 2 minutes, le résultat est le suivant :
On peut voir que nous avons obtenu les informations relatives à cette vidéo, y compris l’ID de la vidéo, le lien vidéo, la miniature, etc. Les explications des champs sont les suivantes :
  • success : indique si la génération a réussi, si oui, alors true, sinon false
  • task_id : l’ID unique de la tâche de génération vidéo
  • video_id : l’ID unique de la vidéo générée par cette tâche
  • prompt : le mot-clé de la tâche de génération vidéo
  • video_url : le lien vers la vidéo résultante de la tâche de génération vidéo
  • video_height : la hauteur de l’image miniature générée
  • video_width : la largeur de l’image miniature générée
  • state : l’état de la tâche de génération vidéo, si la tâche est terminée, alors completed.
  • thumbnail_url : le lien vers l’image miniature générée
  • thumbnail_width : la largeur de l’image miniature générée
  • thumbnail_height : la hauteur de l’image miniature générée

​
Génération de cadres personnalisés

Si vous souhaitez générer une vidéo en personnalisant les cadres de début et de fin, vous pouvez entrer les liens d’image des cadres : À ce moment-là, le champ start_image_url peut recevoir l’image suivante comme première image de la vidéo : Première image Ensuite, pour personnaliser la génération de la vidéo en fonction des cadres de début et de fin, vous pouvez spécifier les éléments suivants :
  • action : le comportement de la tâche de génération vidéo, généralement generate pour une génération normale et extend pour une génération étendue, par défaut generate.
  • start_image_url : spécifie la première image de la vidéo générée.
  • end_image_url : spécifie la dernière image de la vidéo générée.
  • prompt : le contenu des mots-clés pour générer la vidéo.
Un exemple de remplissage est le suivant :

Après avoir rempli, le code généré est le suivant :

Le code correspondant :
Le résultat obtenu est le suivant :
Le résultat final est similaire à celui ci-dessus, la première image de la vidéo générée contient l’image que nous avons fournie, et il est également possible de fournir simultanément des liens d’images pour les cadres de début et de fin pour générer la vidéo, il suffit d’ajouter une image de cadre de fin sur la base de ce qui précède, les informations de l’image de cadre de fin sont les suivantes : Dernière image Un exemple de remplissage est le suivant :

Dernièrement, nous avons obtenu les résultats suivants :
Les résultats sont similaires à ceux ci-dessus, la vidéo générée contient à la fois l’image de la première et de la dernière image, ce qui complète la personnalisation des images de début et de fin pour générer la vidéo.

​
Fonctionnalité d’extension vidéo

Si vous souhaitez continuer à générer la vidéo produite, vous pouvez définir le paramètre action sur extend, et entrer l’ID de la vidéo ou le lien de la vidéo que vous souhaitez continuer à générer. L’ID de la vidéo et le lien de la vidéo peuvent être obtenus selon l’utilisation de base, comme indiqué dans l’image ci-dessous :

À ce moment-là, vous pouvez voir que l’ID de la vidéo est :
Remarque : ici, l’ video_id et le video_url de la vidéo sont l’ID et le lien de la vidéo générée. 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.
Pour continuer à générer la vidéo, vous devez télécharger le lien de la vidéo ou l’ID de la vidéo. Ci-dessous, nous démontrons l’utilisation de l’ID de la vidéo pour l’extension. Ensuite, nous devons remplir les mots-clés pour personnaliser la génération de la vidéo, ce qui nous permet de spécifier le contenu suivant :
  • action : à ce moment, l’action d’extension de la vidéo, qui doit être extend.
  • prompt : les mots-clés pour étendre la vidéo.
  • video_url : le lien de la vidéo à étendre.
  • video_id : l’ID unique de la vidéo à étendre.
  • end_image_url : le lien de l’image de la dernière image à spécifier pour l’extension, paramètre optionnel.
L’exemple de remplissage est le suivant :

Une fois rempli, le code généré automatiquement est le suivant :

Le code Python correspondant :
En cliquant sur exécuter, vous pouvez constater que vous obtiendrez un résultat, comme suit :
On peut voir que cette vidéo a été étendue sur la base de la vidéo à étendre, le contenu des résultats est cohérent avec celui ci-dessus, ce qui permet de réaliser la fonction de génération continue de la chanson. Bien sûr, nous pouvons également spécifier le lien de la vidéo pour effectuer l’extension, en remplissant les informations suivantes :

Après exécution, nous avons obtenu le résultat suivant :
D’après les résultats, on peut voir que la fonctionnalité d’extension de vidéo peut également être réalisée en fonction du lien vidéo. Enfin, nous pouvons également spécifier une image de dernière image pour l’extension de la vidéo, ci-dessous les informations de l’image de dernière image : Dernière image Ensuite, sur la base de ce qui précède, nous ajoutons les informations de l’image de dernière image, comme suit :

En cliquant sur exécuter, nous obtenons les informations suivantes :
On peut voir qu’en se basant sur l’extension de la vidéo ci-dessus, il est également possible de spécifier une image de dernière image pour l’extension.

​
Rappel asynchrone

Étant donné que le temps de génération de vidéo de Luma 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 pour les rappels asynchrones. Le processus global est le suivant : lorsque le client initie une demande, il spécifie en plus un champ callback_url. Après que le client a lancé la demande API, l’API renvoie 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 génération musicale 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 maintenant un exemple pour comprendre comment procéder concrètement. Tout d’abord, le rappel 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. Pour faciliter la démonstration, nous utilisons un site d’exemple Webhook public 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/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Ensuite, nous pouvons définir le champ callback_url sur l’URL Webhook ci-dessus, tout en remplissant prompt, comme illustré ci-dessous :

En cliquant sur exécuter, vous constaterez que vous obtiendrez immédiatement un résultat, comme suit :
Après un court instant, nous pouvons observer le résultat de la chanson générée sur https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, comme illustré ci-dessous : Le contenu est le suivant :
On peut voir que le résultat contient un champ task_id, les autres champs étant similaires à ceux mentionnés ci-dessus, permettant ainsi de relier les tâches via ce champ.