Le modèle texte vers vidéo de PixVerse génère une vidéo fluide à partir d’un prompt textuel.
Activation du service
- Accédez à la console Model Studio, recherchez PixVerse, trouvez la carte du modèle PixVerse et cliquez sur Activer maintenant.
- Dans la fenêtre contextuelle, confirmez l’activation et l’autorisation.
Remarques sur l’utilisation
Pour que les appels d’API aboutissent, utilisez un modèle, une URL de point de terminaison et une clé API qui appartiennent tous à la même région. Les appels entre régions échouent.
- Sélectionner un modèle: Vérifiez la région de votre modèle.
- Sélectionner une URL: Choisissez l’URL de point de terminaison correspondante. Les URL HTTP et du SDK DashScope sont prises en charge.
- Configurer une clé API: Sélectionnez une région, obtenez une clé API, puis configurez-la comme variable d’environnement.
- Installer le SDK: Pour effectuer des appels via un SDK, installez le SDK DashScope.
Appels HTTP
La génération de vidéo à partir de texte est une tâche de longue durée qui prend généralement de 1 à 5 minutes ; l’API utilise donc des appels asynchrones. Le processus comprend deux étapes principales : « Créer une tâche -> Interroger périodiquement le résultat ». Les étapes sont les suivantes :
Étape 1 : créer une tâche pour obtenir un ID de tâche
Région de Singapour: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Remplacez {WorkspaceId} par votre véritable ID d’espace de travail.
- Après la création de la tâche, utilisez le
task_idrenvoyé pour consulter le résultat. Letask_idest valable 24 heures. Ne créez pas de tâches en double ; interrogez plutôt périodiquement le résultat. - Pour débuter, consultez Appeler les API avec Postman ou cURL.
Paramètres de requêteEn-têtesContent-Typestring (Obligatoire)Le type de contenu de la requête. Doit être application/json.Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.X-DashScope-Async string (Obligatoire)Active le traitement asynchrone. Les requêtes HTTP prennent uniquement en charge les appels asynchrones. Doit être enable.Corps de la requêtemodelstring (Obligatoire)Le nom du modèle.Valeurs valides :
object (Obligatoire)Les informations d’entrée de base, telles que le prompt.
Propriétés prompt string (Obligatoire)Le prompt textuel. Il décrit les éléments et les caractéristiques visuelles souhaités dans la vidéo générée.Le chinois et l’anglais sont pris en charge. Chaque caractère chinois ou chaque lettre compte pour un caractère. L’encodage des caractères est UTF-8. Les caractères excédentaires sont automatiquement tronqués.
object (Obligatoire)Les paramètres de génération vidéo, tels que la résolution, la durée et la génération ou non de l’audio.
Propriétés size string (Obligatoire)La résolution de la vidéo générée, au format width*height en pixels.Le tableau suivant répertorie les valeurs valides selon les niveaux de résolution et les rapports d’aspect.
Modèle pixverse/pixverse-v6-t2v
integer (Obligatoire)La durée de la vidéo générée, en secondes.
boolean (Facultatif)Indique s’il faut générer une vidéo avec audio. Si cette option est activée, le modèle génère automatiquement une musique de fond ou des effets sonores adaptés au contenu de la vidéo.
boolean (Facultatif)Indique s’il faut ajouter un filigrane. Il est placé en bas à droite de la vidéo et contient le texte fixe "AI Generated".
string (Facultatif)Modèle pris en charge : pixverse/pixverse-v6-t2v.Spécifie le type de plan de la vidéo générée. Ce paramètre détermine si la vidéo se compose d’un seul plan continu ou de plusieurs plans.
integer (Facultatif)La graine aléatoire doit être un entier compris dans l’intervalle [0, 2147483647].Si elle n’est pas spécifiée, une graine aléatoire est générée. Une graine fixe améliore la reproductibilité.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats identiques. |
Modèle pris en charge : pixverse/pixverse-v6-t2v. |
Paramètres de réponseoutputobjectInformations de sortie de la tâche.
Propriétés task_id stringL’ID de la tâche. Valable pour les requêtes pendant 24 heures.task_status stringL’état de la tâche.
Valeurs d’énumération
stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage.code stringCode d’erreur. Renvoyé uniquement en cas d’échec de la requête. Consultez Codes d’erreur.message stringMessage d’erreur détaillé. Renvoyé uniquement en cas d’échec de la requête. Consultez Codes d’erreur. |
Conservez le task_id pour consulter l’état et le résultat de la tâche. |
Étape 2 : consulter le résultat à l’aide de l’ID de tâche
Région de Singapour: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
- Recommandation d’interrogation périodique: La génération vidéo peut prendre plusieurs minutes. Utilisez un mécanisme d’interrogation périodique et consultez le résultat à un intervalle raisonnable, par exemple toutes les 15 secondes.
- Évolution de l’état de la tâche: PENDING (en file d’attente) → RUNNING (en cours) → SUCCEEDED (réussi) / FAILED (échoué).
- Validité de l’ID de tâche: Le
task_idest valable 24 heures. Passé ce délai, les requêtes échouent et l’API renvoie l’état de tâcheUNKNOWN. - Limite de RPS: Le point de terminaison de consultation est limité par défaut à 20 RPS. Pour des requêtes fréquentes ou des notifications d’événements, configurez les rappels de tâches asynchrones.
- Autres opérations: Pour les consultations par lots, l’annulation de tâches et d’autres opérations, consultez Gérer les tâches asynchrones.
Paramètres de requêteEn-têtesAuthorizationstring (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.Paramètres de chemintask_idstring (Obligatoire)L’ID de la tâche. |
Remplacez {task_id} par la valeur task_id renvoyée par l’appel d’API précédent. Le task_id est valable pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d’espace de travail. |
Paramètres de réponseoutputobjectInformations de sortie de la tâche.
Propriétés task_id stringL’ID de la tâche. Valable pour les requêtes pendant 24 heures.task_status stringL’état de la tâche.
Valeurs d’énumération
stringL’heure d’envoi de la tâche. Format : YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringL’heure d’exécution de la tâche. Format : YYYY-MM-DD HH:mm:ss.SSS.end_time stringL’heure de fin de la tâche. Format : YYYY-MM-DD HH:mm:ss.SSS.video_url stringL’URL de la vidéo. Renvoyée uniquement lorsque task_status est SUCCEEDED.La vidéo est au format MP4 (encodage H.264). Le lien de la vidéo n’expire pas actuellement, mais n’est pas destiné à un stockage à long terme. Téléchargez la vidéo rapidement.orig_prompt stringLe prompt d’entrée original, correspondant au paramètre de requête prompt.code stringCode d’erreur. Renvoyé uniquement en cas d’échec de la requête. Consultez Codes d’erreur.message stringMessage d’erreur détaillé. Renvoyé uniquement en cas d’échec de la requête. Consultez Codes d’erreur.objectStatistiques d’utilisation de la sortie, comptabilisées uniquement pour les tâches réussies.
Propriétés duration integerLa durée totale de la vidéo générée, en secondes, utilisée pour la facturation.size stringLa résolution de la vidéo générée.fps integerLa fréquence d’images de la vidéo générée.SR stringLe niveau de résolution de la vidéo générée.audio booleanIndique si la vidéo générée contient de l’audio.video_count integerLe nombre de vidéos générées. La valeur est fixée à 1.shot_type stringLe type de plan de la vidéo générée.stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. |
|
Appels du SDK DashScope
Les noms de paramètres du SDK correspondent en grande partie à ceux de l’API HTTP. La structure des paramètres est adaptée aux spécificités de chaque langage de programmation.
Les tâches texte vers vidéo prenant beaucoup de temps (généralement de 1 à 5 minutes), le SDK encapsule le processus d’appel asynchrone HTTP et prend en charge les modes d’appel synchrone et asynchrone.
Le temps réellement nécessaire dépend du nombre de tâches en file d’attente et de l’état d’exécution du service. Patientez jusqu’à l’obtention du résultat.
Appels du SDK Python
Région de Singapour: region="ap-southeast-1"
Remplacez {WorkspaceId} par votre véritable ID d’espace de travail.
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
video_url n’expire pas actuellement, mais n’est pas destiné à un stockage à long terme. Téléchargez la vidéo rapidement.
Appels du SDK Java
Région de Singapour: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
Remplacez {WorkspaceId} par votre véritable ID d’espace de travail.
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
video_url n’expire pas actuellement, mais n’est pas destiné à un stockage à long terme. Téléchargez la vidéo rapidement.