API видео Wan 3.0
Параметры, комбинации медиа, асинхронные задачи, загрузки и посекундная тарификация для wan3.0-video на APIMaster.
API видео Wan 3.0
wan3.0-video — это стандартная модель Wan 3; это отдельная модель от wan3.0-video-prime. Она поддерживает текст, изображения, видео, аудио, документы и общедоступные веб-страницы. Каждая успешная задача создаёт одно видео MP4/H.264 длительностью до 30 секунд. Интеграция проверена: 2026-11-17.
В одном запросе допускается не более 20 медиаобъектов суммарно. Частота кадров результата — 30 fps.
Эндпоинты и аутентификация
| Операция | Эндпоинт |
|---|---|
| Создание | 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
Все параметры запроса
Используйте один формат медиа на запрос. Для сочетания референсов разных типов или для документов используйте metadata.input.media.
| Параметр | Тип | Обязательный / по умолчанию | Значение и допустимые значения |
|---|---|---|---|
model |
string | Обязательный | Строго wan3.0-video; не заменяйте на Prime |
prompt |
string | Обязательный | Опишите результат на китайском или английском языке; официальное ограничение — 20 000 символов, более длинный нативный текст усекается. Ссылайтесь на Image 1, Video 1, Audio 1 в порядке медиа; каждый тип медиа имеет собственную нумерацию |
duration |
integer | 5 |
2–30 секунд вывода; -1 позволяет модели выбрать длительность. При наличии референсного видео суммарная длительность ввода и вывода не может превышать 30 секунд |
seconds |
string | Необязательный | Псевдоним длительности, например "5" или "-1"; при указании обоих параметров должен совпадать с duration |
resolution |
string | 1080P |
480P, 720P, 1080P; значения верхнего уровня в нижнем регистре нормализуются |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Необязательный | Псевдоним для aspect_ratio; для расширения видео рекомендуется adaptive |
size |
string | Необязательный | Совместимый псевдоним: уровень разрешения или поддерживаемое пиксельное отображение, например 1280x720; предпочитайте явное указание разрешения и соотношения, а не произвольные пиксельные размеры |
generate_audio |
boolean | true на стороне upstream |
Наличие звуковой дорожки в выводе. Явное false сохраняется. Аудио не влияет на посекундную ставку |
audio |
boolean | Необязательный | Псевдоним для generate_audio; используйте один переключатель аудио |
prompt_extend |
boolean | true |
Интеллектуальное переписывание промпта; явное false сохраняется. Должно быть true для ввода документа/страницы |
watermark |
boolean | false на стороне upstream |
Добавить водяной знак в вывод; явное false сохраняется |
seed |
integer | Случайный | -1 или 0–2147483647. Пропуск или -1 запрашивает случайный seed; 0 передаётся. Повторные seed не гарантируют идентичный вывод |
input_reference |
string | Необязательный | URL изображения первого кадра; заменяет нативный массив медиа. Не смешивайте стили ввода |
images |
string[] | Необязательный | Массив для удобства, добавляемый как элементы reference_image, если input_reference отсутствует |
metadata |
object | Необязательный | Контейнер для нативных объектов ниже; не может изменить выбранную модель |
metadata.input |
object | Необязательный | Нативный объект input |
metadata.input.prompt |
string | Необязательный | Нативное переопределение промпта; сохраняйте обязательный промпт верхнего уровня |
metadata.input.media |
object[] | Необязательный | Упорядоченный массив медиа. Каждый элемент требует type и url; см. ограничения ниже |
metadata.input.media[].type |
string | Обязательный для элемента | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Обязательный для элемента | Публичный HTTP(S) URL медиа; типы изображений также принимают строку data:{MIME_type};base64,.... Медиа, не являющиеся изображениями, требуют публичный URL |
metadata.parameters |
object | Необязательный | Нативный объект параметров; не может быть null |
metadata.parameters.resolution |
string | 1080P |
Верхний регистр 480P, 720P, 1080P |
metadata.parameters.ratio |
string | adaptive |
Те же значения соотношения сторон, что перечислены выше |
metadata.parameters.duration |
integer | 5 |
2–30 или -1; то же ограничение суммарной длительности |
metadata.parameters.audio |
boolean | true на стороне upstream |
Тот же переключатель аудио вывода |
metadata.parameters.prompt_extend |
boolean | true |
Тот же переключатель переписывания промпта; для file/link требуется true |
metadata.parameters.watermark |
boolean | false на стороне upstream |
Тот же переключатель водяного знака |
metadata.parameters.seed |
integer | Случайный | Тот же диапазон seed, включая явный 0 |
Нативные поля negative_prompt, img_url, first_frame_url, last_frame_url и audio_url не являются средствами управления медиа Wan 3. Вместо них используйте документированный массив медиа.
Ограничения на медиафайлы и допустимые комбинации
| Тип медиа | Количество и ограничения |
|---|---|
first_frame, last_frame |
Не более одного каждого. Последний кадр требует наличия первого кадра. Управление кадрами нельзя комбинировать с какими-либо типами reference, file или link |
reference_image |
Не более 10. JPEG/JPG, PNG без прозрачности, BMP или WEBP; каждая сторона 240–8 000 пикселей, соотношение сторон не более 8:1, каждый файл не более 20 МБ |
reference_video |
Не более 5 клипов MP4/MOV; каждый 1–15 секунд, суммарный вход не более 15 секунд; не менее 16 кадров в секунду; каждая сторона 240–4 096 пикселей, соотношение сторон не более 8:1, каждый файл не более 100 МБ |
reference_audio |
Не более 5 клипов WAV/MP3; каждый 1–15 секунд, суммарно не более 15 секунд; каждый файл не более 15 МБ |
file |
Не более одного файла DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; не более 100 МБ. Постраничные документы PDF, DOCX, DOC, PPTX, PPT и KEY/PAGES имеют ограничение в 50 страниц |
link |
Не более одной общедоступной страницы без входа в систему; не комбинировать с file |
Изображения, видео и аудио для референса можно комбинировать. Файл или ссылка могут сопровождать референсные медиа. Режим первого/последнего кадра принимает только управление кадрами; для генерации по аудио используйте режим референсного изображения вместе с референсным аудио. Разбор медиа и модерация контента по-прежнему подчиняются проверкам на стороне upstream-сервиса.
Генерация видео из текста использует промпт без медиа. Анимация по первому кадру использует first_frame; переходы используют first_frame вместе с last_frame. Референсная генерация использует референсные типы. Для редактирования или продления предоставьте reference_video и опишите редактирование или продление в промпте; для продления используйте adaptive.
Примеры
Текст в видео
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Первый и последний кадры
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","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","prompt":"Animate Image 1 to the rhythm 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"}]}}}
Редактирование / продление видео и умная длительность
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Документ / веб-страница
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Замените все примеры URL на реальные общедоступные медиа. Для веб-ввода замените элемент file на {"type":"link","url":"https://example.com/product"}. Пример с первым кадром также работает без элемента последнего кадра.
Ответы, опрос, загрузки и логи
При создании возвращается идентификатор задачи APIMaster, а не идентификатор вышестоящего провайдера:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Поле ответа | Значение |
|---|---|
id / task_id |
Идентификатор задачи платформы, используемый для запроса и загрузки |
status |
queued, in_progress, completed, failed |
progress |
Индикатор прогресса; дождитесь конечного статуса |
error.code, error.message |
Информация об ошибке, если применимо |
metadata.url |
Расположение содержимого, если возвращается при завершении |
Опрашивайте примерно каждые 15 секунд, используя тот же API-ключ. Не создавайте другую задачу для проверки прогресса. Идентификаторы задач и URL-адреса результатов у исходного провайдера истекают через 24 часа; своевременно загружайте и сохраняйте успешные результаты. Предпочтительно использовать аутентифицированную конечную точку содержимого APIMaster вместо хранения временных URL-адресов вышестоящего провайдера.
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 wan3.mp4
Журнал использования содержит задачу и успешный результат видео. Проверьте итоговое начисление после завершения; принятие задачи не является подтверждением успешной генерации. Повторный опрос не создаёт дополнительную плату за генерацию.
Тарификация
Посекундные тарифы указаны в карточке модели.
APIMaster складывает длительность всех входных видео и длительность выходного видео, один раз округляет сумму вверх до целой секунды и применяет посекундный тариф для выбранного разрешения выхода. При 2,3 с входа и 5 с выхода оплачиваются 8 с. Без входного видео оплачивается только длительность выхода. Предварительная оценка и указание длительности входа не требуются. При ошибке генерации резерв возвращается. Итоговая сумма доступна в журнале использования.
Ошибки и исправления
| Симптом | Исправление |
|---|---|
| Недопустимая длительность/разрешение/соотношение сторон | Используйте перечисление и диапазоны выше; умная длительность — ровно -1 |
| Конфликт кадра/референса, последний кадр без первого | Соблюдайте правила комбинирования |
| Файл/ссылка вместе с отключённым переписыванием | Установите prompt_extend:true |
| Сбой получения/формата/длительности медиа | Используйте публичные файлы, соответствующие всем ограничениям по размеру, формату и длительности |
| Отсутствует prompt | Сохраняйте непустой prompt верхнего уровня для API APIMaster |
| Задача завершилась с ошибкой или была подвергнута модерации | Проверьте error, затем исправьте запрос; не считайте принятие запроса успехом |
