APIMaster.ai

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, затем исправьте запрос; не считайте принятие запроса успехом