Wan2.7
Генерация видео Wan2.7
- Модель генерации видео Alibaba Cloud Wanxiang 2.7 (единая точка входа)
- Автоматический выбор режима по параметрам: текст-в-видео / изображение-в-видео (первый кадр, первый-последний кадр, продление видео)
- Поддержка разрешений 720P/1080P, длительность 2–15 секунд
- Поддержка пользовательского аудио (фоновая музыка в режиме текст-в-видео, управляющее аудио в режиме изображение-в-видео)
POST
Авторизация
string
обязательно
Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте в заголовок запроса:
Маршрутизация режимов
wan2.7 — единая точка входа для текст-в-видео и изображение-в-видео. Бэкенд автоматически определяет режим по входным параметрам. Оба режима тарифицируются одинаково:
Параметры запроса
string
обязательно
Имя модели генерации видео, фиксированное значение
wan2.7boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
true: проверить промпты и входные изображения с помощьюomni-moderation-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
Описание содержания видео, до 5000 символов
- Режим Text-to-Video (без изображения/видео): обязательный
- Режим Image-to-Video: опциональный, но рекомендуется для управления движением камеры и действиями
"A cat chasing butterflies on the grass, bright sunshine, slow motion"array<string>
Массив URL изображений. Передача автоматически активирует режим Image-to-Video
- 1 изображение: первый кадр для видео
- 2 изображения: первый и последний кадр для видео (1-е = первый кадр, 2-е = последний кадр)
image_with_rolesarray<object>
Массив изображений с ролями, альтернатива
image_urls, для точного указания роли каждого изображенияПоля каждого объекта:url(string): URL изображения (поддерживает http/https)role(string): роль изображения,first_frame/last_frame, по умолчаниюfirst_frame
array<string>
Массив URL видео. Передача активирует режим продления видео (используется только 1-е видео)
Ограничения видео:
- Формат: mp4, mov
- Длительность: 2–10 с
- Разрешение: ширина и высота в диапазоне [240, 4096] пикселей
- Соотношение сторон: 1:8 – 8:1
- Размер файла: до 100 МБ
string
Негативный промпт, описывающий нежелательное содержание, до 500 символовПример:
"blurry, distorted, low quality"string
по умолчанию:"1080P"
Разрешение видеоВарианты:
720P— стандартное1080P— высокая чёткость (по умолчанию)
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживаемый диапазон:
2 – 15 секундПо умолчанию: 5string
по умолчанию:"16:9"
Соотношение сторон, действует только в режиме Text-to-Video (без изображения/видео)Поддерживаемые форматы:
16:9— широкоэкранный пейзаж (по умолчанию)9:16— портрет1:1— квадрат4:3— пейзаж3:4— портрет
string
URL пользовательского аудио
- Режим Text-to-Video: используется как фоновая музыка
- Режим Image-to-Video: используется как управляющее аудио, синхронизированное с действиями на экране
boolean
по умолчанию:"true"
Включить ли интеллектуальное переписывание промптаЗначительно улучшает результаты для коротких промптов, но увеличивает время обработкиПо умолчанию:
trueboolean
по умолчанию:"false"
Добавлять ли водяной знак «AI Generated» к сгенерированному видео
true: добавить водяной знакfalse: без водяного знака (по умолчанию)
integer
Целое число — зерно для управления случайностью генерируемого содержимогоДиапазон: целое
≥ 0- Для идентичных запросов модель генерирует разные результаты при разных значениях seed (например, при пропуске seed)
- Для идентичных запросов модель генерирует похожие результаты при одинаковом значении seed, но точное совпадение не гарантируется
Ответ
integer
Код статуса ответа, 200 при успехе
array
Массив данных ответа
Сценарии использования
Сценарий 1: Текст в видео (простейший запрос)
Сценарий 2: Текст в видео (полный набор параметров)
Сценарий 3: Первый кадр для видео
Сценарий 4: Первый и последний кадр для видео
При 2 изображениях: 1-е — первый кадр, 2-е — последний. Также можно использовать image_with_roles для точного указания.
Сценарий 5: Продление видео
Сценарий 6: Изображение + управляющее аудио
Руководство по выбору режима
Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает
task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.