Skip to main content
POST

Авторизация

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

Маршрутизация режимов

wan2.7 — единая точка входа для текст-в-видео и изображение-в-видео. Бэкенд автоматически определяет режим по входным параметрам. Оба режима тарифицируются одинаково:

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

string
обязательно
Имя модели генерации видео, фиксированное значение wan2.7
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
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_roles
image_urls конфликтует с audio_url; их нельзя передавать одновременно
array<object>
Массив изображений с ролями, альтернатива image_urls, для точного указания роли каждого изображенияПоля каждого объекта:
  • url (string): URL изображения (поддерживает http/https)
  • role (string): роль изображения, first_frame / last_frame, по умолчанию first_frame
Пример:
image_with_roles конфликтует с audio_url; их нельзя передавать одновременно
array<string>
Массив URL видео. Передача активирует режим продления видео (используется только 1-е видео)
video_urls конфликтует с audio_url; их нельзя передавать одновременно
Ограничения видео:
  • Формат: mp4, mov
  • Длительность: 2–10 с
  • Разрешение: ширина и высота в диапазоне [240, 4096] пикселей
  • Соотношение сторон: 1:8 – 8:1
  • Размер файла: до 100 МБ
string
Негативный промпт, описывающий нежелательное содержание, до 500 символовПример: "blurry, distorted, low quality"
string
по умолчанию:"1080P"
Разрешение видеоВарианты:
  • 720P — стандартное
  • 1080P — высокая чёткость (по умолчанию)
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживаемый диапазон: 215 секундПо умолчанию: 5
string
по умолчанию:"16:9"
Соотношение сторон, действует только в режиме Text-to-Video (без изображения/видео)Поддерживаемые форматы:
  • 16:9 — широкоэкранный пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
  • 4:3 — пейзаж
  • 3:4 — портрет
Этот параметр игнорируется в режиме Image-to-Video; соотношение сторон автоматически определяется входным изображением
string
URL пользовательского аудио
  • Режим Text-to-Video: используется как фоновая музыка
  • Режим Image-to-Video: используется как управляющее аудио, синхронизированное с действиями на экране
Формат: wav / mp3, длительность 2–30 секунд, размер файла ≤ 15 МБ
audio_url конфликтует с video_urls, image_urls и image_with_roles; их нельзя передавать одновременно
boolean
по умолчанию:"true"
Включить ли интеллектуальное переписывание промптаЗначительно улучшает результаты для коротких промптов, но увеличивает время обработкиПо умолчанию: true
boolean
по умолчанию:"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. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.