Modèles Luma AI - Amazon Bedrock

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modèles Luma AI

Cette section décrit les paramètres de demande et les champs de réponse pour les modèles d’IA Luma. Utilisez ces informations pour effectuer des appels d'inférence vers les modèles Luma AI avec l'StartAsyncInvokeopération. Cette section inclut également des exemples de code Python qui montrent comment appeler des modèles d’IA Luma. Pour utiliser un modèle dans une opération d’inférence, vous avez besoin de l’ID du modèle.

  • ID du modèle : luma.ray-v 2:0

  • Nom du modèle : Luma Ray 2

  • Modèle texte vers vidéo

Les modèles Luma AI traitent les demandes du modèle de manière asynchrone en utilisant l'asynchrone APIs , y compris, et. StartAsyncInvokeGetAsyncInvokeListAsyncInvokes

Le modèle d’IA Luma traite les invites en suivant les étapes suivantes.

  • L'utilisateur invite le modèle à l'aide StartAsyncInvokede.

  • Attendez que le InvokeJob soit terminé. Vous pouvez utiliser GetAsyncInvoke ou ListAsyncInvokes pour vérifier l’état d’achèvement de la tâche.

  • La sortie du modèle sera placée dans le compartiment Amazon S3 de sortie spécifié.

Pour plus d'informations sur l'utilisation des modèles Luma AI avec le APIs, voir Génération de vidéos.

Appel d’inférence Luma AI.

POST /async-invoke HTTP/1.1 Content-type: application/json { "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "your input text here", "aspect_ratio": "16:9", "loop": false, "duration": "5s", "resolution": "720p" }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Champs

  • prompt : (chaîne) contenu nécessaire à la sortie vidéo (1 <= longueur <= 5 000 caractères).

  • aspect_ratio : (enum) rapport hauteur/largeur de la vidéo de sortie (« 1:1 », « 16:9 », « 9:16 », « 4:3 », « 3:4, « 21:9 », « 9:21 »).

  • loop : (booléen) indique s’’il faut mettre en boucle la vidéo de sortie.

  • duration : (enum) durée de la sortie vidéo (« 5s », « 9s »).

  • résolution : (enum) résolution de la vidéo de sortie (« 540p », « 720p »).

Le MP4 fichier sera stocké dans le compartiment Amazon S3 tel que configuré dans la réponse.

Text-to-Video Génération

Générez des vidéos à partir d’invites textuelles à l’aide du modèle Luma Ray 2. Le modèle prend en charge diverses options de personnalisation, notamment le rapport hauteur/largeur, la durée, la résolution et le bouclage.

Text-to-VideoDemande de base

{ "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "an old lady laughing underwater, wearing a scuba diving suit" }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Avancé Text-to-Video avec options

{ "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "an old lady laughing underwater, wearing a scuba diving suit", "aspect_ratio": "16:9", "loop": true, "duration": "5s", "resolution": "720p" }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Text-to-VideoExemple supplémentaire

Exemple avec paramètres de résolution et de durée.

{ "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "a car", "resolution": "720p", "duration": "5s" }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Image-to-Video Génération

Transformez des images statiques en vidéos dynamiques en fournissant des séquences clés. Vous pouvez spécifier des séquences de début, des séquences de fin ou les deux pour contrôler le processus de génération vidéo.

Basic Image-to-Video avec cadre de départ

{ "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "A tiger walking in snow", "keyframes": { "frame0": { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3" } } } }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Image-to-Video avec cadres de début et de fin

{ "modelId": "luma.ray-v2:0", "modelInput": { "prompt": "A tiger walking in snow", "keyframes": { "frame0": { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3" } }, "frame1": { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3" } } }, "loop": false, "aspect_ratio": "16:9" }, "outputDataConfig": { "s3OutputDataConfig": { "s3Uri": "s3://your-bucket-name" } } }

Paramètres supplémentaires pour Image-to-Video

  • keyframes — (object) Définit les images-clés de début (frame0) de and/or fin (frame1)

    • frame0 : image de séquence clé de départ

    • frame1 : image de séquence clé de fin

    • type : doit être « image »

    • source : source de l’image

Résolution des problèmes

Problèmes courants et solutions liés à l’utilisation des modèles d’IA Luma :

  • État de tâche « Échec » : vérifiez que votre compartiment S3 dispose des autorisations d’écriture appropriées et qu’il existe dans la même région que votre service Bedrock.

  • Erreurs d'accès à l'URL de l'image : assurez-vous que l'image URLs est accessible au public et utilisez le protocole HTTPS. Les images doivent être aux formats pris en charge (PNG ou JPEG).

  • Erreurs de paramètres non valides : vérifiez que les valeurs du rapport hauteur/largeur correspondent aux options prises en charge (« 1:1 », « 16:9 », « 9:16 », « 4:3 », « 3:4 », « 21:9 », « 9:21 ») et que la durée est de « 5s » ou « 9s ».

  • Problèmes de délai d’attente : utilisez GetAsyncInvoke pour vérifier le statut de la tâche plutôt que d’attendre de manière synchrone. La génération d’une vidéo peut prendre plusieurs minutes.

  • Erreurs de longueur d’invite : maintenez les invites entre 1 et 5 000 caractères. Les invites plus longues seront rejetées.

Notes de performance

Considérations importantes concernant les performances et les limites du modèle d’IA Luma :

  • Temps de traitement : la génération de vidéos prend généralement de 2 à 5 minutes pour les vidéos de 5 secondes et de 4 à 8 minutes pour les vidéos de 9 secondes, selon la complexité.

  • Exigences relatives à l’image : les images d’entrée doivent être de haute qualité avec une résolution minimale de 512 x 512 pixels. La taille d’image maximale prise en charge est de 4 096 x 4 096 pixels.

  • Taille de la vidéo de sortie : les vidéos générées varient de 5 à 50 Mo en fonction de la durée, de la résolution et de la complexité du contenu.

  • Limites de débit : les appels d’API asynchrones sont soumis à des quotas de service. Surveillez votre utilisation et les augmentations de quotas de demande si nécessaire.

  • Stockage S3 : garantissez une capacité de stockage S3 suffisante pour les vidéos de sortie et considérez les politiques de cycle de vie pour optimiser les coûts.

Documents associés

Pour des informations supplémentaires et des services connexes :