Luma AImodèles - 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.

Luma AImodèles

Cette section décrit les paramètres de demande et les champs de réponse pour les modèles Luma AI. 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 Luma AI. Pour utiliser un modèle dans une opération d'inférence, vous avez besoin de son identifiant.

  • Identifiant 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 Luma AI traite les instructions 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.

Luma AIappel d'inférence.

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) Le contenu requis dans la vidéo de sortie (1 <= longueur <= 5000 caractères).

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

  • loop — (boolean) 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'instructions 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 images-clés. Vous pouvez spécifier des images de début, des images 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 d'image-clé de départ

    • frame1 — Fin de l'image clé

    • 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 Luma AI :

  • État du job « É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 dans des formats compatibles (JPEG, PNG).

  • 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 : GetAsyncInvoke à utiliser pour vérifier l'état de la tâche plutôt que d'attendre de manière synchrone. La génération de vidéos peut prendre plusieurs minutes.

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

Remarques sur le rendement

Considérations importantes concernant les performances et les limites du modèle Luma AI :

  • 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 demandez des augmentations de quotas 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 :