Générez des vidéos réalistes et fluides à partir de descriptions textuelles avec le modèle HappyHorse.
Disponibilité
Le modèle, l'URL de l'endpoint et la clé API doivent appartenir à la même région. Les appels interrégionaux échouent.
- Sélectionner un modèle : Vérifiez la région du modèle.
- Sélectionner une URL : Utilisez l'URL de l'endpoint correspondant à la région. Le protocole HTTP est pris en charge.
- Configurer une clé API : Obtenez une clé API pour la région, puis exportez-la sous forme de variable d'environnement.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
Requête HTTP
Les tâches de génération vidéo durent généralement entre 1 et 5 minutes. L'API fonctionne de manière asynchrone en deux étapes : « Création de tâche → Interrogation des résultats ».
Étape 1 : Créer une tâche et obtenir son ID
- 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.
- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Ne créez pas de tâches en double ; privilégiez l'interrogation périodique pour récupérer le résultat. - Pour un guide destiné aux débutants, consultez Appeler des API avec Postman ou cURL.
Paramètres de la requête |
|
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'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. La valeur doit être enable. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Pour consulter les modèles disponibles, reportez-vous à la console Model Studio.Exemple : happyhorse-1.1-t2v. | |
input object (Obligatoire)Entrées du modèle.
Propriétés prompt string (Obligatoire)Description textuelle de la vidéo à générer.Toutes les langues sont prises en charge. Limite : 5 000 caractères non chinois ou 2 500 caractères chinois. Tout excédent est tronqué. | |
parameters object (Facultatif)Paramètres de sortie vidéo (résolution, format d'image, durée).
Propriétés resolution string (Facultatif)Résolution de la vidéo générée.Valeurs autorisées :
string (Facultatif)Format d'image de la vidéo générée.Valeurs autorisées :
integer (Facultatif)Durée de la vidéo générée, en secondes.
boolean (Facultatif)Indique s'il faut ajouter un filigrane. Affiche « HappyHorse » dans le coin inférieur droit.
integer (Facultatif)La graine aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si aucune valeur n'est spécifiée, une graine aléatoire est générée automatiquement. Une graine fixe améliore la reproductibilité des résultats.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats strictement identiques. |
Paramètres de la réponse |
Conservez le task_id afin d'interroger ultérieurement l'état et le résultat de la tâche. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. |
Étape 2 : Interroger le résultat via l'ID de 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}- Interrogation recommandée : La génération vidéo nécessitant plusieurs minutes, mettez en place un mécanisme d'interrogation à intervalles réguliers, par exemple toutes les 15 secondes.
- Transition des états : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Lorsqu'une tâche aboutit, une URL vidéo valide pendant 24 heures est retournée. Téléchargez et sauvegardez rapidement la vidéo dans un stockage permanent, tel qu'OSS.
- Validité du task_id : 24 heures. Passé ce délai, les requêtes retournent l'état
UNKNOWN.
Paramètres de la requête |
Remplacez {task_id} par la valeur task_id retournée lors de l'appel API précédent. Le task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre ID d'espace de travail. |
En-têtes | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin | |
task_id string (Obligatoire)Identifiant de la tâche. |
Paramètres de la réponse |
Les URL vidéo ne sont valides que 24 heures avant d'être automatiquement supprimées. Sauvegardez sans tarder les vidéos générées. |
outputobjectInformations de sortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est indiquée 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 indiquée 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 indiquée 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. Retournée uniquement lorsque task_status vaut SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.orig_prompt stringInvite d'entrée originale, correspondant au paramètre de requête prompt.code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
usage objectStatistiques de sortie. Seules les tâches réussies sont comptabilisées.
Propriétés input_video_duration integerDurée de la vidéo d'entrée, en secondes.output_video_duration integerDurée de la vidéo générée, en secondes.duration integerDurée vidéo totale prise en compte pour la facturation.SR integerRésolution de la vidéo générée.ratio stringFormat d'image de la vidéo générée.video_count integerNombre de vidéos générées. Toujours égal à 1. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. |