Создать видео
Создавайте задачи Wan 3.0 с нативной структурой ввода.
Отправляйте задачи стандартной модели через model/input/parameters. Используются адрес API и API Key платформы, Workspace ID Alibaba Cloud не требуется. Асинхронность включается автоматически, заголовок X-DashScope-Async добавлять не нужно.
/api/v1/services/aigc/video-generation/video-synthesisАутентификация
bearerAuth Используйте API Key платформы: Authorization: Bearer your-api-key.
Расположение: header
Тело запроса
application/json
Определения типов TypeScript
Используйте тип request body в TypeScript.
Отправка нативной структуры. Асинхронность включается автоматически, X-DashScope-Async не нужен.
Тело ответа
application/json
application/json
application/json
Материалы и правила сочетаний
Нужен промпт или непустой media. Изображения, видео и аудио нумеруются отдельно в порядке элементов своего типа: «图1», «视频1», «音频1». Дополнительный ID референса не нужен.
| Материал | Формат и количество | Основные ограничения |
|---|---|---|
| Первый/последний кадры | Не более 1 first_frame и 1 last_frame | Последний требует первого; несовместимы с референсами изображений, видео, аудио, файлами и страницами |
| Изображения | До 10 reference_image | JPEG/JPG/PNG без альфа-канала/BMP/WEBP; до 20MB каждое; стороны 240–8000px; соотношение до 8:1 |
| Видео | До 5 reference_video | MP4/MOV; каждое 1–15 секунд, суммарно до 15 секунд; файл до 100MB; стороны 240–4096px; минимум 16fps; соотношение до 8:1 |
| Аудио | До 5 reference_audio | WAV/MP3; каждое 1–15 секунд, суммарно до 15 секунд; файл до 15MB |
| Файл | До 1 file | До 100MB; PDF, Word, PowerPoint, Keynote, Pages — до 50 страниц; форматы в таблице полей |
| Веб-страница | До 1 link | Публичная HTTP/HTTPS страница без авторизации; несовместима с файлом |
Первый/последний кадры имеют те же ограничения, что изображения-референсы. Изображения принимают публичный URL или Base64 с префиксом, например data:image/png;base64,...; остальные материалы — URL. Для обычных материалов допустим доступный OSS, для страниц — только HTTP/HTTPS. Если URL не страницы имеет расширение, оно должно соответствовать формату; без расширения всё равно нужны допустимые характеристики содержимого.
Изображения, видео и аудио можно совмещать, добавляя файл или страницу, но file и link взаимоисключающие. Для них включайте prompt_extend. Редактирование и продление задаются видео-референсом и промптом; при продлении используйте ratio: "adaptive".
Длительность — -1 (умная) или целое 2～30 секунд. При видео-референсе входная и выходная длительности суммарно не превышают 30 секунд.
Результат и дальнейшие действия
Сохраните output.task_id и получите статус и результат через нативное получение. request_id нужен для диагностики, а не поиска задачи. Не создавайте задачу повторно ради прогресса.
Для общих полей используйте платформенное создание. Не смешивайте два формата.
Типичные ошибки
При HTTP 400 проверьте JSON, модель, input/parameters и сочетания материалов по сообщению ошибки. Ответ может использовать code/message/data или вложенный error. Передавайте поддержке ошибку и ID запроса, но не API Key.