API Wan 3.0 Video Prime

Используйте wan3.0-video-prime через асинхронный видео API APIMaster. Текущая интеграция поддерживает 480P / 720P / 1080P, целые значения от 2 до 30 секунд и одно видео на задачу. Проверка параметров и интеграции: 2026-10-26.

Конечные точки и аутентификация

Операция	Метод и URL
Создание	POST https://apimaster.ai/v1/videos
Запрос	GET https://apimaster.ai/v1/videos/{task_id}
Загрузка	GET https://apimaster.ai/v1/videos/{task_id}/content

Используйте Authorization: Bearer YOUR_API_KEY в каждом запросе и Content-Type: application/json при создании задачи. Используйте ключ API APIMaster, а не ключ Alibaba Cloud. APIMaster предоставляет вышестоящий асинхронный заголовок; вам не нужен X-DashScope-Async.

Совместимая конечная точка создания /videos/generations возвращает другую структуру ответа; в приведённых ниже примерах последовательно используется /videos.

Текущие возможности маршрутов

В настоящее время эту модель обслуживают две интеграции: нативный маршрут Alibaba Cloud и маршрут GMI. Расширенные поля требуют соответствующего маршрута; отправка поля не выбирает этот маршрут. Перед использованием примеров для конкретного маршрута убедитесь, к какому маршруту имеет доступ ваш ключ API.

Возможность	Нативный Alibaba Cloud	GMI
Текст-в-видео, первый кадр, первый/последний кадры, референсные изображения	Интегрировано	Интегрировано, с другими полями медиа
Референсное аудио	metadata.input.media	audio_url
Документ / публичная веб-страница	Нативные поля медиа пересылаются; не покрываются проверкой завершённой генерации	Не поддерживается
Референсное видео, редактирование, продление	Блокируется до отправки	Не поддерживается
Автоматическая длительность -1	Блокируется	Блокируется
Соотношение сторон 21:9	Принимается	Отклоняется
Явное переключение аудио	generate_audio / audio	Не поддерживается; опустите эти поля
Отключение переписывания промпта / фиксированный seed 0	Текущая сериализация не сохраняет prompt_extend: false или seed: 0; не полагайтесь на них	Явные false и 0 сохраняются

Нативный маршрут с 5-секундным беззвучным видео 720P успешно завершил генерацию, загрузку и декодирование в приёмочной проверке 2026-10-24. Другие комбинации медиа описаны по адаптеру и официальному контракту, а не представлены как протестированные генерацией комбинации. Доступность маршрутов и цены могут меняться; см. карточку модели.

Полные общие параметры запроса

Отправляйте эти поля на верхнем уровне. Для максимальной совместимости используйте явные duration, resolution и aspect_ratio, непустой промпт длиной не более 5 000 символов и опускайте параметры, специфичные для маршрута.

Поле	Тип	Обязательно / по умолчанию	Поведение APIMaster
model	string	Обязательно	Ровно wan3.0-video-prime
prompt	string	Обязательно на обоих маршрутах	Непустой, в том числе при генерации изображения. GMI проверяет длину 1–5 000 символов; нативный адаптер требует непустой текст. Официальный нативный лимит — 20 000; избегайте зависимости от этого более высокого лимита на разных маршрутах
duration	integer	5	2–30 секунд; без -1, дробей или автоматической длительности
seconds	string	Необязательно	Строковый псевдоним, например "5"; должен совпадать с duration, если указаны оба
resolution	string	720P	480P, 720P, 1080P; значения в нижнем регистре на верхнем уровне нормализуются. Это значение APIMaster по умолчанию отличается от официального нативного значения по умолчанию
aspect_ratio	string	16:9	Распространённые значения: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 только на нативном маршруте
ratio	string	Необязательно	Псевдоним aspect_ratio; используйте одно поле и не отправляйте конфликтующие значения
size	string	Необязательно	Псевдоним размеров, например 1280x720; применяется валидация конкретного маршрута. Предпочитайте resolution и aspect_ratio. GMI требует, чтобы короткая сторона соответствовала уровню разрешения; нативный маршрут принимает только поддерживаемые им сопоставления размеров
input_reference	string	Необязательно	URL изображения первого кадра. Для кросс-маршрутной совместимости используйте публично загружаемый HTTP(S) URL; не комбинируйте с другими входными данными первого кадра
prompt_extend	boolean	Нативный true; GMI оставляет значение провайдера по умолчанию, если опущено	Переписывание промпта. Нативный маршрут в настоящее время не может надёжно отключить его с помощью false; GMI пересылает явное логическое значение
watermark	boolean	Официальное нативное значение по умолчанию false; GMI оставляет значение провайдера по умолчанию, если опущено	Переключатель водяного знака
seed	integer	Случайное значение, если опущено	Переносимый фиксированный диапазон: 1–2147483647. Нативный маршрут также принимает -1 для случайного значения; нативный 0 опускается при сериализации. GMI принимает 0–2147483647 и отклоняет -1. Фиксированный seed не гарантирует идентичный результат

Нативные псевдонимы размеров: 832x480, 480x832, 1280x720, 720x1280, 1920x1080 и 1080x1920 для обычных альбомных/портретных случаев. Некоторые сопоставления квадратных размеров сводятся к 1:1; другие сопоставленные размеры всё ещё могут не пройти валидацию соотношения сторон. Не используйте size для запроса произвольных размеров.

Таблицы параметров для конкретных маршрутов

Поля GMI

Это поля верхнего уровня в дополнение к общей таблице. Адаптер GMI отклоняет нераспознанные поля, включая metadata, images, image_urls, audio, generate_audio, video_urls и reference_video.

Поле	Тип	Обязательно / по умолчанию	Поведение
negative_prompt	string	Необязательно	Не более 500 символов
first_frame	string	Необязательно	Публичный HTTP(S) URL изображения; альтернатива input_reference
last_frame	string	Необязательно	Публичный HTTP(S) URL изображения последнего кадра; также укажите первый кадр
reference_image	string or string[]	Необязательно	1–10 публичных HTTP(S) URL референсных изображений; для нескольких изображений используйте массив
audio_url	string	Необязательно	Публичный HTTP(S) URL референсного аудио; подчиняется валидации медиа у провайдера

Используйте в одном запросе либо управление кадрами, либо референсные изображения. Нативный metadata.input.media не преобразуется в эти поля на GMI.

Нативные поля Alibaba Cloud

Нативные структурированные входные данные должны находиться внутри metadata. Отправка официальных объектов input или parameters напрямую на верхнем уровне не соответствует контракту APIMaster. Всегда сохраняйте обязательный prompt на верхнем уровне.

Поле	Тип	Обязательно / по умолчанию	Поведение
generate_audio	boolean	Официальное нативное значение по умолчанию true	Содержит ли выходная дорожка аудио; false сохраняется
audio	boolean	Необязательно	Псевдоним generate_audio; укажите только один
images	string[]	Необязательно	Преобразуется в медиаэлементы reference_image; это не упорядоченные первый/последний кадры. Не комбинируйте с input_reference
metadata	object	Необязательно	Оборачивает нативные input и parameters; не может изменить model
metadata.input	object	Необязательно	Нативный контейнер входных данных
metadata.input.prompt	string	Необязательно	Нативное переопределение промпта; предпочтительно использовать только промпт верхнего уровня
metadata.input.media	object[]	Необязательно	Нативная коллекция медиа, в каждом элементе должны быть type и url
metadata.input.media[].type	string	Обязательно для каждого элемента	first_frame, last_frame, reference_image, reference_audio, file, link; reference_video в настоящее время отклоняется
metadata.input.media[].url	string	Обязательно для каждого элемента	Расположение медиа; рекомендуются публичные HTTP(S) URL. Официальные временные URL OSS требуют отдельно действительного контекста загрузки на стороне вышестоящего сервиса; APIMaster не предоставляет этот контекст загрузки
metadata.parameters	object	Необязательно	Нативный контейнер параметров; не должен быть null
metadata.parameters.resolution	string	720P	Верхний регистр 480P, 720P, 1080P
metadata.parameters.ratio	string	16:9	Нативные соотношения сторон, включая adaptive и 21:9
metadata.parameters.duration	integer	5	2–30; без -1
metadata.parameters.audio	boolean	Официальное нативное значение по умолчанию true	Переключатель выходного аудио
metadata.parameters.prompt_extend	boolean	true	Должен оставаться true для file / link; явный false имеет описанное выше ограничение сериализации
metadata.parameters.watermark	boolean	Официальное нативное значение по умолчанию false	Переключатель водяного знака
metadata.parameters.seed	integer	Случайное значение	-1 или 0–2147483647; 0 имеет описанное выше ограничение сериализации

Нативные параметры верхнего уровня переопределяют соответствующие параметры metadata. input_reference верхнего уровня заменяет нативный массив медиа; images добавляет элементы референсных изображений, когда input_reference отсутствует. Используйте один стиль входных данных и один стиль параметров, чтобы избежать случайных переопределений. Не используйте устаревшие img_url, first_frame_url, last_frame_url или audio_url внутри нативного input; адаптер отклоняет эти устаревшие поля медиа для Wan 3.0.

Ограничения медиа

Официальные нативные правила медиа ниже также объясняют валидацию на стороне провайдера; то, что адаптер принимает URL, не доказывает, что медиа валидно.

Медиа	Ограничения / примечания по интеграции
Первый / последний кадры	Не более одного каждого; последний кадр требует первого кадра. Не смешивайте управление кадрами с reference_image
Референсные изображения	Не более 10; JPEG/JPG, PNG без прозрачности, BMP или WEBP; каждая сторона 240–8 000 px, соотношение сторон не более 8:1, не более 20 МБ на изображение
Референсное аудио	Нативно: не более 5, WAV/MP3, каждое 1–15 секунд, суммарно не более 15 секунд, не более 15 МБ на файл. GMI предоставляет один audio_url
Файл / веб-страница	Только нативно: не более одного файла или одной публично читаемой страницы; не комбинируйте file и link. Официальные форматы файлов: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD; не более 100 МБ, с ограничением в 50 страниц для применимых постраничных форматов. Сохраняйте prompt_extend: true
Референсное видео	Официально доступно, но в настоящее время блокируется нативной валидацией биллинга APIMaster; не предоставляется на GMI. Не используйте здесь примеры редактирования или продления видео из официального API

Официальный нативный лимит суммарного количества медиа — 20 элементов; при этом отдельные лимиты и лимиты комбинаций продолжают действовать. URL данных Base64 изображений являются частью официального нативного формата входных данных, но не принимаются валидацией URL GMI. Для кросс-маршрутной совместимости предпочитайте загружаемые HTTP(S) URL.

Примеры

Текст-в-видео, общие поля

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

Первый кадр, общие поля

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

GMI первый / последний кадры

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Нативные первый / последний кадры и беззвучный вывод

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Нативное референсное изображение и аудио

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Замените примерные URL медиа реальными публичными файлами. Примеры для конкретных маршрутов требуют соответствующего маршрута и по-прежнему подчиняются проверкам комбинаций на стороне вышестоящего сервиса.

Ответ, опрос и загрузка

Создание возвращает ID задачи APIMaster, например:

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

Поле	Значение
id / task_id	Идентификатор задачи APIMaster, а не идентификатор задачи вышестоящего сервиса
status	queued, in_progress, completed, failed
progress	Сообщаемый прогресс; не гарантия завершения
error.code / error.message	Детали ошибки, если применимо
metadata.url	Аутентифицированный адрес содержимого, когда возвращается при завершении

Опрашивайте каждые 10–20 секунд с тем же ключом API до достижения терминального статуса; успешное создание означает только принятие задачи. Генерация может занимать несколько минут. Опрашивайте принятую задачу вместо повторного создания платных задач.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Загрузите и сохраните завершённое видео своевременно; URL результатов на стороне вышестоящего сервиса могут истечь. Повторный опрос не создаёт дополнительную плату за генерацию.

Биллинг и распространённые ошибки

Биллинг осуществляется посекундно при запрошенном разрешении, а цены для маршрута/аккаунта показаны в карточке модели. При отправке резервируется расчётная стоимость. Нативное завершение использует возвращённую оплачиваемую длительность и зафиксированную на момент отправки цену; GMI следует контракту зарезервированной длительности. Неудачные задачи освобождают/возвращают резерв на генерацию. Отключённое аудио не означает более дешёвый тариф. Для окончательной суммы используйте журнал использования.

Ошибка / симптом	Действие
duration must be an integer from 2 to 30	Используйте явное целое число; -1 не интегрирован
unsupported Wan request field ...	Удалите поле, не поддерживаемое GMI, или подтвердите доступ к соответствующему нативному маршруту
unsupported aspect ratio	Используйте распространённое соотношение; 21:9 требует нативного маршрута
reference video requires an input-duration quote	Удалите референсное видео; эта возможность в настоящее время заблокирована
prompt is required / сбой получения медиа	Добавьте текст верхнего уровня; используйте публично загружаемые валидные медиа
prompt_extend: false или seed: 0 не влияет на нативный маршрут	Текущее ограничение сериализации; используйте положительный seed и не полагайтесь на отключение переписывания

Источники: официальная информация о модели, официальная справочная документация по нативному API и официальное руководство по использованию. Официальная возможность не означает, что то же поле предоставляется на каждом маршруте APIMaster.