Skip to main content
POST
  • Модель генерации видео Alibaba Cloud Wanxiang
  • Поддержка трёх режимов: текст-в-видео, изображение-в-видео и референсное видео (r2v)
  • Сервер автоматически выбирает нужную модель на основе параметров запроса
  • Поддержка разрешений 720p/1080p, длительность 5/10/15 секунд
  • Не-Flash версия всегда включает аудио в выходное видео
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

Логика маршрутизации

Сервер автоматически выбирает модель на основе параметров запроса:

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

string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключамиДобавьте в заголовок запроса:

Параметры запроса

string
обязательно
Название модели генерации видео, фиксированное значение wan2.6
string
обязательно
Описание содержимого видеоОбязательно для режима текст-в-видео; опционально для изображение-в-видео и референсного видео (описывает желаемое движение или стиль)Пример: "Милый котенок потягивается на солнце"
string[]
Массив URL референсных изображений (режим изображение-в-видео, поддерживает только 1 изображение)⚠️ Только формат URL (base64 больше не поддерживается)
  • Публично доступный URL изображения (http:// или https://)
  • Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL
Пример: ["https://example.com/image.jpg"]Примечание: Нельзя использовать вместе с metadata.reference_urls
string
по умолчанию:"16:9"
Соотношение сторон видео (для режимов текст-в-видео и референсного видео)Доступные значения:
  • 16:9 - Горизонтальный (по умолчанию)
  • 9:16 - Вертикальный
  • 1:1 - Квадрат
  • 4:3 - Горизонтальный
  • 3:4 - Вертикальный
По умолчанию: 16:9Примечание: Не поддерживается в режиме изображение-в-видео
string
по умолчанию:"1080p"
Разрешение видеоДоступные значения:
  • 720p - Стандартное
  • 1080p - Высокое качество (по умолчанию)
По умолчанию: 1080p480p не поддерживается. Тарификация посекундная; разные разрешения имеют разную стоимость.
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживается: 5, 10, 15По умолчанию: 5
string
Негативный промпт — описывает нежелательное содержимоеПример: "размытый, низкое качество, деформированный"
integer
Случайное зерно для воспроизводимости результатовПример: 12345
boolean
по умолчанию:"true"
Автоматическое расширение промптаПри включении система автоматически оптимизирует и обогащает ваш промпт. Включено по умолчанию — установите false для отключения.
boolean
Включить аудио в видеоНе-Flash модели Wan2.6 по умолчанию генерируют видео со звуком. Установите true для явного включения.
string
Тип съёмки (для режимов текст-в-видео и референсного видео)Доступные значения:
  • single - Один непрерывный план
  • multi - Несколько планов (кинематографический монтаж)
boolean
Добавить водяной знак Alibaba Cloud на видео
object
Расширенные параметры

Комбинации разрешений и соотношений сторон

Ответ

string
Уникальный идентификатор задачи для последующих запросов
string
Тип объекта, всегда generation.task
string
Использованное название модели
string
Статус задачи
  • queued - В очереди
  • in_progress - Обрабатывается
  • completed - Успешно завершена
  • failed - Ошибка
integer
Прогресс задачи в процентах (0-100)
integer
Временная метка создания задачи (Unix timestamp)
object
Метаданные задачи

Сценарии использования

Сценарий 1: Текст-в-видео

Сценарий 2: Изображение-в-видео

Сценарий 3: Референсное видео (r2v)

Сценарий 4: Текст-в-видео (полные параметры)

Получение результатов задачиГенерация видео — асинхронная задача. После отправки возвращается task_id. Используйте интерфейс Получить статус видео для запроса прогресса и результатов.