Créer une vidéo

Créez des tâches Wan 3.0 texte-vers-vidéo, image-vers-vidéo ou à références multimodales avec les champs communs de la plateforme.

Le format plateforme utilise les champs racine et metadata ; n’y placez pas directement input/parameters du format natif. La création est asynchrone. Consultez le résultat après l’envoi.

POST/v1/videos

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez l’API Key de la plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

Fournissez un prompt ou metadata.media non vide. Utilisez JSON, pas multipart/input_reference/image/images.

model*"wan3.0-video"

Nom de modèle fixé à wan3.0-video.

Valeur par défaut"wan3.0-video"

Valeurs autorisées

"wan3.0-video"

prompt?Prompt

Description de la vidéo, jusqu’à 20000 caractères. Fournissez un prompt ou un tableau de médias non vide. Les références sont numérotées par type : utilisez 图1, 视频1 et 音频1 dans le prompt.

Longueurlength <= 20000

size?string

Raccourci de résolution. Priorité : size non vide → metadata.resolution non vide → metadata.size non vide → 1080P. Les chaînes blanches sont omises. Utilisez 480P/720P/1080P, pas des dimensions en pixels.

duration?integer

Raccourci de durée, entier JSON. Priorité : duration explicite → seconds non vide → metadata.duration → 5. Une valeur prioritaire invalide ne déclenche pas de repli.

Plage-1 <= value <= 30

seconds?string

Raccourci de durée, chaîne entière telle que "5" ou "-1". Les chaînes blanches sont omises. Moins prioritaire que duration explicite, plus que metadata.duration. Préférez un seul champ.

Motif^(?:-1|[2-9]|[12][0-9]|30)$

seed?integer

seed au niveau racine est prioritaire sur metadata.seed ; la valeur explicite 0 est conservée.

Plage-1 <= value <= 2147483647

metadata?

Paramètres Wan supplémentaires. N’utilisez pas input/parameters ni les champs d’autres modèles ; seuls les champs métier indiqués sont acceptés.

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/v1/videos" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "At the seaside at dawn, the camera slowly pushes forward as a seagull glides over the water",
    "size": "720P",
    "duration": 5
  }'

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1792760030
}

Paramètres et priorités

Réglage	Saisie et priorité
Prompt et médias	Fournissez `prompt` ou `metadata.media` non vide ; les images n’utilisent pas `image/images/input_reference` à la racine
Résolution	`size` non vide → `metadata.resolution` non vide → `metadata.size` non vide → `1080P` ; indiquez un palier, pas des dimensions en pixels
Durée	`duration` explicite → `seconds` non vide → `metadata.duration` → `5` ; `duration` est un entier, `seconds` une chaîne entière
Graine	`seed` explicite à la racine est prioritaire sur `metadata.seed` ; `0` est valide
Autres réglages	Placez le rapport d’aspect, le son, la réécriture et le filigrane dans `metadata` ; `false` explicite est conservé

Préférez un champ par réglage. Les chaînes blanches de résolution et de seconds sont considérées absentes ; prompt peut être omis avec des médias. Une valeur prioritaire invalide provoque une erreur sans repli.

Scénarios et médias

Les exemples couvrent texte, image initiale, images initiale/finale, références mixtes, fichier, page web, édition et extension. Remplacez les URL d’exemple des médias par vos propres URL accessibles.

Le mode images initiale/finale n’accepte pas de médias de référence ; l’image finale nécessite l’initiale. Choisissez un fichier ou une page web et activez la réécriture. Consultez les règles des médias et combinaisons pour les formats, quantités, dimensions et durées ; elles s’appliquent aussi au format plateforme.

Résultats de création et chemins compatibles

La création renvoie un objet video. Conservez id et consultez l’API de consultation plateforme. Le champ compatible task_id vaut id. queued signifie accepté, pas terminé.

POST /v1/video/generations et POST /v1/videos/generations acceptent les mêmes paramètres et renvoient la même structure. Pour une nouvelle intégration, utilisez POST /v1/videos.

Erreurs courantes

Pour HTTP 400, vérifiez selon l’erreur les types, les paliers de résolution, les combinaisons de médias et les noms de champs metadata. L’erreur peut utiliser code/message/data ou un objet error imbriqué.

Documentation officielle Alibaba Cloud Wan 3.0 — génération vidéoRéférence du protocole natif ; les champs et réponses plateforme suivent cette page.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Paramètres et priorités

Scénarios et médias

Résultats de création et chemins compatibles

Erreurs courantes

`application/json`

`application/json`

`application/json`