Создать видео

Создавайте видео Wan 3.0 по тексту, изображениям и мультимодальным референсам через общие поля платформы.

Формат платформы использует корневые параметры и metadata, а не нативные input/parameters. Создание асинхронное; после отправки получите результат отдельным запросом.

POST/v1/videos

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте API Key платформы: Authorization: Bearer your-api-key.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

Нужен промпт или непустой metadata.media. Используйте JSON, не multipart/input_reference/image/images.

model*"wan3.0-video"

Имя модели фиксировано: wan3.0-video.

По умолчанию"wan3.0-video"

Допустимые значения

"wan3.0-video"

prompt?Prompt

Описание видео, до 20000 символов. Нужен промпт или непустой массив материалов. Референсы нумеруются по типам; используйте 图1, 视频1, 音频1 в промпте.

Длинаlength <= 20000

size?string

Быстрое задание разрешения. Приоритет: непустой size → непустой metadata.resolution → непустой metadata.size → 1080P. Пробельные строки считаются отсутствующими. Используйте 480P/720P/1080P, не размеры в пикселях.

duration?integer

Быстрое задание длительности целым числом JSON. Приоритет: явный duration → непустой seconds → metadata.duration → 5. Недопустимое старшее значение не заменяется младшим.

Диапазон-1 <= value <= 30

seconds?string

Длительность строкой целого числа, например "5" или "-1". Пробельная строка пропускается. Приоритет ниже явного duration и выше metadata.duration. Лучше использовать одно поле.

Шаблон^(?:-1|[2-9]|[12][0-9]|30)$

seed?integer

Корневой seed приоритетнее metadata.seed; явно заданный 0 сохраняется.

Диапазон-1 <= value <= 2147483647

metadata?

Дополнительные параметры Wan. Не используйте input/parameters или поля других моделей; допустимы только перечисленные поля.

Тело ответа

`application/json`

curl -X POST "https://api.agtcloud.cn/v1/videos" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "prompt": "At the seaside at dawn, the camera slowly pushes forward as a seagull glides over the water",
    "size": "720P",
    "duration": 5
  }'

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

Параметры и приоритеты

Настройка	Заполнение и приоритет
Промпт и материалы	Нужен `prompt` или непустой `metadata.media`; для изображений не используются корневые `image/images/input_reference`
Разрешение	Непустой `size` → непустой `metadata.resolution` → непустой `metadata.size` → `1080P`; задавайте уровень, не размеры в пикселях
Длительность	Явный `duration` → непустой `seconds` → `metadata.duration` → `5`; `duration` — целое число, `seconds` — строка целого числа
Seed	Явный корневой `seed` приоритетнее `metadata.seed`; `0` допустим
Остальное	Соотношение сторон, звук, переработку промпта и водяной знак задавайте в `metadata`; явный `false` сохраняется

Лучше задавать настройку одним способом. Пробельные строки разрешения и seconds считаются отсутствующими; при наличии материалов prompt можно опустить. Недопустимое старшее значение вызывает ошибку, а не переход к младшему.

Сценарии и материалы

Примеры охватывают текст, первый кадр, первый/последний кадры, смешанные референсы, файл, веб-страницу, редактирование и продление. Замените URL примеров своими доступными адресами.

Первый/последний кадры несовместимы с референсами; последний требует первого. Выберите файл или веб-страницу и включите переработку промпта. Форматы, количество, размеры и длительности описаны в правилах материалов и сочетаний; они действуют и для платформенного формата.

Результат создания и совместимые пути

Создание возвращает объект video. Сохраните id и используйте получение в формате платформы. Совместимое поле task_id равно id. queued означает принятие, а не готовность видео.

Также поддерживаются POST /v1/video/generations и POST /v1/videos/generations с теми же параметрами и ответами. Для новых интеграций используйте POST /v1/videos.

Типичные ошибки

При HTTP 400 проверьте по сообщению типы параметров, разрешение, сочетания материалов и имена полей metadata. Ошибка может находиться в code/message/data или вложенном объекте error.

Официальная документация Alibaba Cloud по генерации видео Wan 3.0Справочник нативного протокола; платформенные поля и ответы описаны на этой странице.

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

Параметры и приоритеты

Сценарии и материалы

Результат создания и совместимые пути

Типичные ошибки

`application/json`

`application/json`

`application/json`