Le modèle HappyHorse référence vers vidéo vous permet de fournir plusieurs images de référence et une invite textuelle pour générer une vidéo combinant les sujets des images dans une scène basée sur l'invite.
Notes d'utilisation
Pour garantir le succès des appels API, utilisez un modèle, une URL d'endpoint et une clé API appartenant tous à la même région. Les appels interrégions échouent.
- Sélectionnez un modèle : Confirmez la région où se trouve votre modèle.
- Sélectionnez une URL : Choisissez l'URL d'endpoint correspondante. Les URLs HTTP et SDK DashScope sont prises en charge.
- Configurez une clé API : Sélectionnez une région, obtenez une clé API, puis configurez la clé API en tant que variable d'environnement.
L'exemple de code de cette rubrique s'applique à la région Singapour.
Appels HTTP
Étant donné que les tâches de référence vers vidéo sont chronophages (généralement 1 à 5 minutes), l'API utilise un appel asynchrone. Le flux de travail comprend deux étapes principales : « Créer une tâche -> Interroger le résultat ».
Étape 1 : Créer une tâche
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} par votre ID d'espace de travail réel.
- Une fois la tâche créée, utilisez le
task_idrenvoyé pour interroger le résultat. Letask_idest valide pendant 24 heures. Ne créez pas de tâches dupliquées. Utilisez plutôt le mécanisme d'interrogation pour récupérer le résultat. - Pour obtenir des conseils destinés aux débutants, consultez la rubrique Appeler des API avec Postman ou cURL.
Paramètres de requête |
| |||||||||
En-têtes de requête | ||||||||||
Content-Type string (Obligatoire)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 ne prennent en charge que les appels asynchrones. Doit être enable. | ||||||||||
Corps de la requête | ||||||||||
model string (Obligatoire)Nom du modèle. Pour connaître les modèles disponibles, consultez la console Model Studio.Exemple : happyhorse-1,1-r2v. | ||||||||||
input object (Obligatoire)Entrée du modèle, comprenant les images de référence et l'invite textuelle.
Propriétés prompt string (Obligatoire)Description des éléments souhaités et du style visuel pour la vidéo générée.La saisie dans n'importe quelle langue est prise en charge. La longueur est limitée à 5 000 caractères non chinois ou 2 500 caractères chinois. Le contenu dépassant cette limite est automatiquement tronqué.Référencement d'image : Dans l'invite, utilisez « [Image 1] » et « [Image 2] » pour faire référence à l'image de référence correspondante dans le tableau media. L'ordre doit être cohérent avec celui du tableau media. Lors de l'utilisation d'une référence, spécifiez l'objet dans l'image, par exemple « la femme en qipao rouge dans [Image 1] ».media array (Obligatoire)Liste des images de référence.Chaque élément du tableau est un objet média contenant les champs type et url.
Propriétés des éléments type string (Obligatoire)Type de ressource multimédia. Définissez cette valeur sur :
string (Obligatoire)URL ou données encodées en Base64 d'une image de référence.Exigences relatives aux images :
| ||||||||||
parameters object (Facultatif)Paramètres de génération de vidéo, tels que la résolution vidéo, le rapport d'aspect et la durée.
Propriétés resolution string (Facultatif)Niveau de résolution de la vidéo générée.Valeurs valides :
string (Facultatif)Rapport d'aspect de la vidéo générée.Valeurs valides :
integer (Facultatif)Durée de la vidéo générée, en secondes.Plage de valeurs : Un entier compris entre 3 et 15.Valeur par défaut : 5.watermark boolean (Facultatif)Indique s'il faut ajouter un filigrane à la vidéo générée. Le filigrane est placé dans le coin inférieur droit avec le texte fixe « Happy Horse ».
integer (Facultatif)La graine aléatoire doit être un entier compris dans la plage [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é.Étant donné que la génération du modèle est probabiliste, la même graine ne garantit pas des résultats identiques. |
Paramètres de réponse |
Enregistrez le task_id pour interroger l'état et le résultat de la tâche. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringID de la tâche. Valide pour les interrogations pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les Codes d'erreur. |
Étape 2 : Obtenir le résultat de la tâche
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
- Japan (Tokyo)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}- Recommandation d'interrogation : La génération de vidéo peut prendre plusieurs minutes. Nous vous recommandons de mettre en œuvre un mécanisme d'interrogation avec un intervalle de requête raisonnable (par exemple, 15 secondes) pour récupérer le résultat.
- Flux d'état de la tâche : PENDING (En file d'attente) → RUNNING (En cours de traitement) → SUCCEEDED (Réussie) ou FAILED (Échouée).
- Validité de l'ID de tâche : L'ID de tâche est valide pendant 24 heures. Passé ce délai, vous ne pouvez plus interroger le résultat et l'API renvoie un état de tâche
UNKNOWN.
Paramètres de requête |
Remplacez {task_id} par la valeur task_id renvoyée par l'appel API précédent. Le task_id est valide pour les interrogations pendant 24 heures, Remplacez {WorkspaceId} par votre ID d'espace de travail réel. |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin d'URL | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de réponse |
Les URL de vidéo ne sont valides que pendant 24 heures, puis sont automatiquement purgées. Enregistrez rapidement les vidéos générées. |
outputobjectInformations de sortie de la tâche.
Propriétés task_id stringID de la tâche. Valide pour les interrogations pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.video_url stringURL de la vidéo générée. Renvoyée uniquement lorsque task_status est SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec encodage H.264.orig_prompt stringInvite d'entrée d'origine, correspondant au paramètre de requête prompt.code stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les Codes d'erreur. | |
usage objectStatistiques d'utilisation de la tâche. Vous êtes facturé uniquement pour les tâches réussies.
Propriétés duration integerDurée facturable de la vidéo générée, en secondes.input_video_duration integerDurée totale de la vidéo d'entrée, en secondes. Cette valeur est toujours 0 pour les tâches de référence vers vidéo.output_video_duration integerDurée totale de la vidéo de sortie, en secondes.ratio stringRapport d'aspect de la vidéo générée.SR integerNiveau de résolution de la vidéo générée.video_count integerNombre de vidéos générées. Cette valeur est toujours 1. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |