Créer une vidéo Wan

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

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

Créez une vidéo Wan à partir de texte, de médias de référence ou des première et dernière images. Stockez le id renvoyé pour interroger la tâche et télécharger la vidéo terminée. POST /v1/videos utilise multipart/form-data. Envoyez une valeur entière explicite pour seconds et un size au format WxH.

Choisir un mode d’entrée

Chaque mode nécessite model et prompt. Les entrées multimédias disponibles dépendent du modèle :

Objectif	ID de modèle	Champs multimédias
Texte vers vidéo	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Omettez les champs multimédias
Image vers vidéo	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL ou fichiers image importés
Vidéo de référence	`wan2.6`	`reference_videos` uniquement
Références d’image et de vidéo	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` avec `reference_videos`
Références d’image, de vidéo et d’audio	`wan3.0`, `wan3.0-prime`	Références d’image/vidéo avec `reference_audios`
Première et dernière images	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, éventuellement `last_frame`

Pour trouver un ID de modèle Wan disponible pour votre clé API, utilisez Lister les modèles disponibles.

Utiliser des images de référence

Pour wan2.7, wan3.0 et wan3.0-prime, envoyez des images de référence via input_reference sous forme d’URL HTTPS accessibles publiquement ou de fichiers importés. Pour plusieurs images, répétez le champ dans l’ordre des images, avec une URL ou un fichier par champ. Utilisez soit uniquement des URL, soit uniquement des fichiers dans input_reference. Envoyez chaque URL séparément au lieu de combiner les URL dans une valeur séparée par des virgules. Utilisez des images PNG ou JPEG d’une taille maximale de 20 Mo chacune. Une seule URL ou un seul fichier input_reference utilise le workflow image vers vidéo. L’image guide la composition et l’apparence ; utilisez le prompt pour décrire le mouvement et le comportement de la caméra. Pour wan3.0 et wan3.0-prime, envoyez au maximum 10 images de référence via input_reference, que vous utilisiez des URL ou des fichiers importés.

Utiliser des vidéos et des fichiers audio de référence

Envoyez les vidéos via reference_videos et les extraits audio via reference_audios, en répétant chaque champ une fois par entrée. Chaque entrée peut être une URL HTTPS accessible publiquement ou un fichier importé. Pour les références vidéo, utilisez des fichiers MP4 avec une vidéo encodée en H.264. Pour les références audio, utilisez des fichiers MP3 distincts. Différents champs peuvent utiliser différents types d’entrée, par exemple une URL d’image avec des vidéos importées. Dans reference_videos ou reference_audios, utilisez uniquement des URL ou uniquement des fichiers. Vous pouvez importer jusqu’à cinq fichiers vidéo, chacun ne dépassant pas 50 Mio (50 × 1024 × 1024 octets). Vous pouvez importer jusqu’à cinq fichiers audio, chacun ne dépassant pas 15 Mio (15 × 1024 × 1024 octets).

Références vidéo Wan 2.6

Envoyez de une à trois reference_videos, de 2 à 30 secondes chacune, d’une taille maximale de 30 MB et d’au moins 16 fps. Ces limites s’appliquent aux URL comme aux vidéos importées. Dans le prompt, désignez les sujets par @Video1, @Video2 et @Video3, dans l’ordre des entrées. Pour ce mode, omettez input_reference, reference_audios, first_frame et last_frame. Définissez seconds sur 5 ou 10. Ces exemples créent une vidéo de cinq secondes à partir de deux références vidéo. Remplacez les URL de médias ou les noms de fichiers par vos entrées :

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=https://your-media-host/reference-1.mp4' \
  -F 'reference_videos=https://your-media-host/reference-2.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=@reference-1.mp4;type=video/mp4' \
  -F 'reference_videos=@reference-2.mp4;type=video/mp4'

Références d’images et de vidéos Wan 2.7

Combinez des références d’images et de vidéos pour guider l’apparence et le mouvement du sujet. Définissez seconds sur un entier compris entre 2 et 10. Omettez reference_audios. Utilisez deux URL d’images ou deux images importées avec une référence vidéo :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4'

Références d’images, de vidéos et de fichiers audio Wan 3.0

Pour wan3.0 et wan3.0-prime, combinez des références d’images et de vidéos avec des références audio pour guider l’apparence, le mouvement et le rythme. Envoyez au maximum cinq références vidéo, pour une durée totale maximale de 15 secondes. Chaque vidéo doit avoir au moins 16 fps. Envoyez au maximum cinq références audio, pour une durée totale maximale de 15 secondes. Comptez séparément la durée des vidéos et celle des fichiers audio. Définissez la seconds de sortie sur un entier compris entre 2 et 30. Utilisez deux URL d’images ou deux images importées avec une vidéo et deux extraits audio :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4' \
  -F 'reference_audios=https://your-media-host/reference-1.mp3' \
  -F 'reference_audios=https://your-media-host/reference-2.mp3'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4' \
  -F 'reference_audios=@reference-1.mp3;type=audio/mpeg' \
  -F 'reference_audios=@reference-2.mp3;type=audio/mpeg'

Utiliser les première et dernière images

Pour wan2.7, wan3.0 et wan3.0-prime, envoyez first_frame pour l’image de début et, éventuellement, last_frame pour l’image de fin. Chaque champ accepte une URL HTTPS accessible publiquement vers une image PNG ou JPEG, ou un fichier PNG ou JPEG importé. Pour les entrées d’image Wan 2.7, l’image de début détermine le format d’image, tandis que size sélectionne le niveau de résolution de sortie. Soumettez les entrées d’image dans une requête distincte de input_reference, reference_videos et reference_audios. Ces exemples Wan 2.7 créent une transition entre les images de début et de fin :

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Ces exemples Wan 3.0 créent une transition entre les images de début et de fin :

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Définir la durée et la taille

Envoyez seconds sous la forme d’un nombre entier dans la plage prise en charge par votre modèle et votre mode d’entrée.

ID de modèle	Mode d’entrée	`seconds`	Par défaut
`wan3.0`, `wan3.0-prime`	Texte, références ou images	entier `2`–`30`	`5` secondes, `1920x1080`
`wan2.7`	Texte	entier `2`–`15`	`5` secondes, `1920x1080`
`wan2.7`	Images	entier `2`–`15`	`5` secondes, niveau `1080p` ; le ratio d’aspect est celui de l’image d’ouverture
`wan2.7`	Références d’images/vidéos	entier `2`–`10`	`5` secondes, `1920x1080`
`wan2.6`	Texte	`5`, `10`, `15`	`5` secondes, `1920x1080`
`wan2.6`	Références vidéo	`5`, `10`	`5` secondes, `1920x1080`

Définissez size sur l’une des valeurs WxH ci-dessous pour le modèle cible. Les valeurs de taille Wan 3.0 s’appliquent également à wan3.0-prime.

Valeurs de taille Wan 3.0

Niveau de résolution	Ratio d’aspect	`size` (`WxH`)
`480p`	`16:9`	`832x480`
	`9:16`	`480x832`
	`1:1`	`624x624`
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`1:1`	`960x960`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Valeurs de taille Wan 2.7

Niveau de résolution	Ratio d’aspect	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Valeurs de taille Wan 2.6

Niveau de résolution	Ratio d’aspect	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Flux des tâches

Créer la tâche

Envoyez la requête de formulaire multipart et stockez le id renvoyé.

Interroger la tâche

Appelez Récupérer une vidéo Wan jusqu’à ce que status soit completed, failed ou error.

Télécharger le résultat

Lorsque la tâche est completed, appelez Récupérer le contenu d’une vidéo Wan pour télécharger le fichier MP4.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data

model

string

requis

Wan model ID: wan2.6, wan2.7, wan3.0, or wan3.0-prime. Use wan2.6 for text or reference-video input. Use wan2.7 for text, image/video references, or frame inputs. Use wan3.0 or wan3.0-prime to also include reference audio.

Exemple:

"wan3.0"

prompt

string

requis

Text prompt that describes the video to generate. Describe the appearance and motion to preserve from references, or the transition between first_frame and last_frame. For wan2.6 video references, use @Video1, @Video2, and @Video3 in input order.

Exemple:

"A small robot walks through a bright greenhouse with smooth camera movement."

seconds

integer

Requested output duration in whole seconds. Send an explicit integer. For wan2.6 reference-to-video, use 5 or 10; text-to-video also accepts 15. For wan2.7 reference-to-video, use 2 through 10; text and frame inputs accept 2 through 15. For wan3.0 and wan3.0-prime, use 2 through 30. Default is 5.

Plage requise: 2 <= x <= 30

Exemple:

5

size

string

Supported WxH size values. For wan3.0 and wan3.0-prime: 832x480, 480x832, 624x624, 640x480, 480x640, 1280x720, 720x1280, 960x960, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Exemple:

"1920x1080"

input_reference

PNG or JPEG reference images for wan2.7, wan3.0, and wan3.0-prime. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. A single URL or file uses the image-to-video workflow. Each image can be up to 20 MB. For wan3.0 and wan3.0-prime, send at most 10 reference images, whether you use URLs or uploaded files. Image and video references can share a request; reference audio requires wan3.0 or wan3.0-prime. Submit frame inputs separately. Omit for text-to-video and wan2.6 reference-to-video. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference videos for wan2.6, wan2.7, wan3.0, and wan3.0-prime. Repeat reference_videos with publicly accessible HTTPS URLs or uploaded MP4 files with H.264 video. Use one input type within this field: all URLs or all files. For wan2.6, send 1 to 3 clips, each 2 to 30 seconds and up to 30 MB, with at least 16 fps; omit image, audio, and frame fields. For wan2.7, combine video references with image references. For wan3.0 and wan3.0-prime, send at most 5 clips totaling at most 15 seconds, with at least 16 fps. Video uploads are limited to 5 files, each at most 50 MiB (50 x 1024 x 1024 bytes); the lower wan2.6 limits still apply. Submit frame inputs separately.

Minimum array length: 1

Pattern: ^https://

reference_audios

(string<uri> | file)[]

Reference audio for wan3.0 and wan3.0-prime, combined with image or video references. Repeat reference_audios with publicly accessible HTTPS MP3 URLs or uploaded MP3 files. Use one input type within this field: all URLs or all files. Send at most 5 audio references totaling at most 15 seconds, counted separately from reference video duration. Audio uploads are limited to 5 files, each at most 15 MiB (15 x 1024 x 1024 bytes). Submit frame inputs separately. Omit for wan2.6 and wan2.7.

Minimum array length: 1

Pattern: ^https://

first_frame

Opening frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use first_frame alone or add last_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

last_frame

Ending frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use with first_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

Réponse

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

requis

Task ID. Use this value with retrieve and content endpoints.

Exemple:

"task_example"

object

string

requis

Object type. Video tasks return video.

Exemple:

"video"

model

string

requis

Model ID used for the task.

Exemple:

"wan3.0"

status

enum<string>

requis

Task lifecycle status. Poll until the value is completed, failed, or error.

Options disponibles:

queued,

in_progress,

completed,

failed,

error

Exemple:

"queued"

progress

integer

requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100

Exemple:

0

created_at

integer

requis

Task creation time as a Unix timestamp in seconds.

Exemple:

1779938152

task_id

string

Compatibility alias for id when present.

Exemple:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Exemple:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Exemple:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Dernière modification le 9 septembre 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

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

Modération de contenu

Clés API

Choisir un mode d’entrée

Utiliser des images de référence

Utiliser des vidéos et des fichiers audio de référence

Références vidéo Wan 2.6

Références d’images et de vidéos Wan 2.7

Références d’images, de vidéos et de fichiers audio Wan 3.0

Utiliser les première et dernière images

Définir la durée et la taille

Valeurs de taille Wan 3.0

Valeurs de taille Wan 2.7

Valeurs de taille Wan 2.6

Flux des tâches

Autorisations

Corps

Réponse

​Choisir un mode d’entrée

​Utiliser des images de référence

​Utiliser des vidéos et des fichiers audio de référence

​Références vidéo Wan 2.6

​Références d’images et de vidéos Wan 2.7

​Références d’images, de vidéos et de fichiers audio Wan 3.0

​Utiliser les première et dernière images

​Définir la durée et la taille

​Valeurs de taille Wan 3.0

​Valeurs de taille Wan 2.7

​Valeurs de taille Wan 2.6

​Flux des tâches

Autorisations

Corps

Réponse

Choisir un mode d’entrée

Utiliser des images de référence

Utiliser des vidéos et des fichiers audio de référence

Références vidéo Wan 2.6

Références d’images et de vidéos Wan 2.7

Références d’images, de vidéos et de fichiers audio Wan 3.0

Utiliser les première et dernière images

Définir la durée et la taille

Valeurs de taille Wan 3.0

Valeurs de taille Wan 2.7

Valeurs de taille Wan 2.6

Flux des tâches