Створення відео 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
}

Створіть відео Wan із тексту, медіафайлів для довідки або першого й останнього кадрів. Збережіть повернений id, щоб опитувати завдання та завантажити готове відео. POST /v1/videos використовує multipart/form-data. Надішліть явне ціле значення seconds і size у форматі WxH.

Виберіть режим введення

Для кожного режиму потрібні model і prompt. Доступні медіавхідні дані залежать від моделі:

Мета	ID моделей	Медіаполя
Текст у відео	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Не вказуйте медіаполя
Зображення у відео	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL-адреси або завантажені файли зображень
Довідкове відео	`wan2.6`	`reference_videos` лише
Довідкові зображення та відео	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` з `reference_videos`
Довідкові зображення, відео та аудіо	`wan3.0`, `wan3.0-prime`	Довідкові зображення/відео з `reference_audios`
Перший і останній кадри	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, за потреби `last_frame`

Щоб знайти ID моделі Wan, доступний для вашого API-ключа, скористайтеся Перегляд доступних моделей.

Використання довідкових зображень

Для wan2.7, wan3.0 і wan3.0-prime надсилайте довідкові зображення через input_reference як загальнодоступні HTTPS URL-адреси або завантажені файли. Для кількох зображень повторюйте поле в порядку зображень: одна URL-адреса або файл на поле. Використовуйте лише URL-адреси або лише файли в межах input_reference. Надсилайте кожну URL-адресу окремо, а не об’єднуйте URL-адреси у значення, розділене комами. Використовуйте зображення PNG або JPEG розміром до 20 МБ кожне. Одна URL-адреса або файл у input_reference використовує процес перетворення зображення у відео. Зображення визначає композицію та вигляд; використовуйте prompt для опису руху та поведінки камери. Для wan3.0 і wan3.0-prime надсилайте не більше 10 довідкових зображень через input_reference, незалежно від того, чи використовуєте ви URL-адреси або завантажені файли.

Використання еталонних відео й аудіо

Надсилайте відео через reference_videos та аудіокліпи через reference_audios, повторюючи кожне поле для кожного вхідного значення. Кожним вхідним значенням може бути загальнодоступна URL-адреса HTTPS або завантажений файл. Для еталонних відео використовуйте файли MP4 із відео, закодованим H.264. Для еталонних аудіо використовуйте окремі файли MP3. Для різних полів можна використовувати різні типи вхідних даних, наприклад URL-адресу зображення із завантаженими відео. У reference_videos або reference_audios використовуйте або лише URL-адреси, або лише файли. Можна завантажити до п’яти відеофайлів, кожен розміром не більше 50 МіБ (50 × 1024 × 1024 байтів). Можна завантажити до п’яти аудіофайлів, кожен розміром не більше 15 МіБ (15 × 1024 × 1024 байтів).

Еталонні відео Wan 2.6

Надішліть від одного до трьох reference_videos, кожне тривалістю 2–30 секунд, розміром до 30 МБ і з частотою щонайменше 16 fps. Ці обмеження застосовуються як до URL-адрес, так і до завантажених відео. У Prompt посилайтеся на суб’єкти як на @Video1, @Video2 і @Video3 у порядку вхідних даних. Для цього режиму не вказуйте input_reference, reference_audios, first_frame і last_frame. Установіть для seconds значення 5 або 10. Ці приклади створюють п’ятисекундне відео на основі двох еталонних відео. Замініть URL-адреси медіафайлів або імена файлів своїми вхідними даними:

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'

Еталонні зображення та відео Wan 2.7

Поєднуйте еталонні зображення та відео, щоб керувати виглядом і рухом суб’єкта. Установіть для seconds ціле число від 2 до 10. Не вказуйте reference_audios. Використовуйте дві URL-адреси зображень або два завантажені зображення з еталонним відео:

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'

Еталонні зображення, відео й аудіо Wan 3.0

Для wan3.0 і wan3.0-prime поєднуйте еталонні зображення та відео з еталонними аудіо, щоб керувати виглядом, рухом і ритмом. Надішліть не більше п’яти еталонних відео із сукупною тривалістю не більше 15 секунд. Частота кожного відео має становити щонайменше 16 fps. Надішліть не більше п’яти еталонних аудіо із сукупною тривалістю не більше 15 секунд. Тривалість відео й аудіо обчислюється окремо. Установіть вихідний seconds на ціле число від 2 до 30. Використовуйте дві URL-адреси зображень або два завантажені зображення з одним відео та двома аудіокліпами:

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'

Використовуйте перший і останній кадри

Для wan2.7, wan3.0 і wan3.0-prime надсилайте first_frame для початкового зображення та, за потреби, last_frame для кінцевого зображення. Кожне поле приймає одну загальнодоступну HTTPS URL-адресу PNG або JPEG чи один завантажений файл PNG або JPEG. Для вхідних кадрів Wan 2.7 початкове зображення визначає співвідношення сторін, а size вибирає рівень вихідної роздільної здатності. Надсилайте вхідні кадри в окремому запиті, окремо від input_reference, reference_videos і reference_audios. Ці приклади Wan 2.7 створюють перехід між початковим і кінцевим кадрами:

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'

Ці приклади Wan 3.0 створюють перехід між початковим і кінцевим кадрами:

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'

Установлення тривалості та розміру

Надсилайте seconds як ціле число в межах діапазону для вашої моделі та режиму введення.

Ідентифікатор моделі	Режим введення	`seconds`	За замовчуванням
`wan3.0`, `wan3.0-prime`	Текст, посилання або кадри	ціле число `2`–`30`	`5` секунд, `1920x1080`
`wan2.7`	Текст	ціле число `2`–`15`	`5` секунд, `1920x1080`
`wan2.7`	Кадри	ціле число `2`–`15`	`5` секунд, рівень `1080p`; співвідношення сторін відповідає початковому зображенню
`wan2.7`	Посилання на зображення/відео	ціле число `2`–`10`	`5` секунд, `1920x1080`
`wan2.6`	Текст	`5`, `10`, `15`	`5` секунд, `1920x1080`
`wan2.6`	Посилання на відео	`5`, `10`	`5` секунд, `1920x1080`

Установіть size на одне зі значень WxH нижче для цільової моделі. Значення розміру Wan 3.0 також застосовуються до wan3.0-prime.

Значення розміру Wan 3.0

Рівень роздільності	Співвідношення сторін	`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`

Значення розміру Wan 2.7

Рівень роздільності	Співвідношення сторін	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Значення розміру Wan 2.6

Рівень роздільності	Співвідношення сторін	`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`

Потік завдання

Створіть завдання

Надішліть багатокомпонентний запит форми та збережіть повернений id.

Опитуйте завдання

Викликайте Отримати відео Wan доки status не матиме значення completed, failed або error.

Завантажте результат

Коли завдання має стан completed, викличте Отримати вміст відео Wan щоб завантажити файл MP4.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

multipart/form-data

model

string

обов'язково

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.

Приклад:

"wan3.0"

prompt

string

обов'язково

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.

Приклад:

"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.

Необхідний діапазон: 2 <= x <= 30

Приклад:

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.

Приклад:

"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://

Відповідь

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

string

обов'язково

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

Приклад:

"task_example"

object

string

обов'язково

Object type. Video tasks return video.

Приклад:

"video"

model

string

обов'язково

Model ID used for the task.

Приклад:

"wan3.0"

status

enum<string>

обов'язково

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

Доступні опції:

queued,

in_progress,

completed,

failed,

error

Приклад:

"queued"

progress

integer

обов'язково

Task progress as a coarse percentage.

Необхідний діапазон: 0 <= x <= 100

Приклад:

0

created_at

integer

обов'язково

Task creation time as a Unix timestamp in seconds.

Приклад:

1779938152

task_id

string

Compatibility alias for id when present.

Приклад:

"task_example"

completed_at

integer

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

Приклад:

1779938219

video_url

string

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

Приклад:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Останнє оновлення 9 вересня 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
}

Модерація контенту

API-ключі

Виберіть режим введення

Використання довідкових зображень

Використання еталонних відео й аудіо

Еталонні відео Wan 2.6

Еталонні зображення та відео Wan 2.7

Еталонні зображення, відео й аудіо Wan 3.0

Використовуйте перший і останній кадри

Установлення тривалості та розміру

Значення розміру Wan 3.0

Значення розміру Wan 2.7

Значення розміру Wan 2.6

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть режим введення

​Використання довідкових зображень

​Використання еталонних відео й аудіо

​Еталонні відео Wan 2.6

​Еталонні зображення та відео Wan 2.7

​Еталонні зображення, відео й аудіо Wan 3.0

​Використовуйте перший і останній кадри

​Установлення тривалості та розміру

​Значення розміру Wan 3.0

​Значення розміру Wan 2.7

​Значення розміру Wan 2.6

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть режим введення

Використання довідкових зображень

Використання еталонних відео й аудіо

Еталонні відео Wan 2.6

Еталонні зображення та відео Wan 2.7

Еталонні зображення, відео й аудіо Wan 3.0

Використовуйте перший і останній кадри

Установлення тривалості та розміру

Значення розміру Wan 3.0

Значення розміру Wan 2.7

Значення розміру Wan 2.6

Потік завдання