Le modèle d'édition vidéo HappyHorse prend en entrée une vidéo et une image de référence, puis exécute des tâches d'édition telles que le transfert de style ou le remplacement local, conformément aux instructions textuelles fournies.
Disponibilité
Assurez-vous que le modèle, l'URL de l'endpoint et la clé API appartiennent tous à la même région. Les appels interrégionaux échouent systématiquement.
- Sélectionner un modèle : Vérifiez la région du modèle.
- Choisir une URL : Utilisez l'URL de l'endpoint correspondant à votre région. Les URL HTTP sont prises en charge.
- Configurer une clé API : Sélectionnez une région, créez une clé API, puis exportez-la en tant que variable d'environnement.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
Requête HTTP
Les tâches d'édition vidéo nécessitant un temps de traitement important (généralement 1 à 5 minutes), l'API fonctionne par appels asynchrones. Le flux de travail se déroule en deux étapes : « Créer une tâche -> Interroger le résultat », comme décrit ci-dessous :
É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 véritable 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 plutôt 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 |
| |||||||||
En-têtes | ||||||||||
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.Valeur fixe : happyhorse-1.0-video-edit. | ||||||||||
input object (Obligatoire)Informations d'entrée comprenant la vidéo à éditer, les images de référence et l'instruction textuelle.
Propriétés prompt string (Obligatoire)Instruction textuelle décrivant la modification souhaitée, telle qu'un transfert de style ou un remplacement local.Toutes les langues sont prises en charge. Limite de 5 000 caractères non chinois ou 2 500 caractères chinois. Le contenu excédentaire est automatiquement tronqué.media array (Obligatoire)Liste des ressources multimédias, incluant la vidéo à éditer et d'éventuelles images de référence.Ce tableau doit contenir exactement 1 élément video et peut optionnellement inclure entre 0 et 5 éléments reference_image.
Propriétés des éléments type string (Obligatoire)Type de ressource multimédia. Doit correspondre à l'une des valeurs suivantes :
string (Obligatoire)URL de la ressource multimédia.
Entrée vidéo (type=video) URL publiquement accessible de la vidéo à éditer.
Durée de la vidéo générée : de 3 à 15 secondes.
Entrée image (type=reference_image) URL ou données encodées en Base64 de l'image de référence.Exigences relatives à l'image :
| ||||||||||
parameters object (Facultatif)Paramètres d'édition vidéo tels que la résolution.
Propriétés resolution string (Facultatif)Résolution de la vidéo générée.Valeurs valides :
boolean (Facultatif)Indique si un filigrane doit être ajouté à la vidéo générée. Celui-ci apparaît dans le coin inférieur droit avec le texte « Happy Horse ». La valeur par défaut est true.
string (Facultatif)Contrôle audio.
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. L'utilisation d'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 les résultats 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 périodique : L'édition vidéo prenant plusieurs minutes, mettez en place un mécanisme d'interrogation à intervalles réguliers (par exemple, toutes les 15 secondes) pour vérifier la disponibilité des résultats.
- Cycle de vie de la tâche : PENDING (en file d'attente) → RUNNING (en cours de traitement) → SUCCEEDED / FAILED.
- Expiration du task_id : L'identifiant de tâche expire au bout de 24 heures. Passé ce délai, les résultats ne sont plus récupérables et l'API retourne un état de tâche
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. Ce task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable 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 pendant 24 heures avant d'être automatiquement supprimées. Pensez à sauvegarder rapidement vos 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 exprimé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 exprimé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 exprimé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 stringInstruction 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 d'utilisation. Ne comptabilise que les résultats réussis.
Propriétés duration floatDurée totale de la vidéo générée, utilisée pour la facturation.SR integerNiveau de résolution de la vidéo générée.output_video_duration floatDurée de la vidéo de sortie, en secondes.input_video_duration floatDurée de la vidéo d'entrée, en secondes.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. |