Skip to main content
POST

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

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

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

string
обязательно
Название модели генерации видео. Фиксировано: pixverse-v6.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Описание содержимого видео, до 5000 символов. Обязателен во всех режимах.
string
по умолчанию:"540p"
Разрешение видео. Влияет на стоимость.
  • 360p: SD
  • 540p: Стандарт (по умолчанию)
  • 720p: HD
  • 1080p: Full HD
Другие значения разрешения возвращают ошибку параметра.
integer
по умолчанию:"5"
Длительность видео в секундах, диапазон 1–15.
Режим перехода между первым и последним кадрами поддерживает только 5 или 8 секунд.
string
по умолчанию:"16:9"
Соотношение сторон видео. Действует только в режимах «текст в видео» и объединения нескольких опорных изображений.
  • 16:9: Горизонтальный широкий (по умолчанию)
  • 4:3: Горизонтальный 4:3
  • 1:1: Квадрат
  • 3:4: Вертикальный 3:4
  • 9:16: Вертикальный
  • 2:3: Вертикальный 2:3
  • 3:2: Горизонтальный 3:2
  • 21:9: Кинематографический широкий
integer
по умолчанию:"0"
Случайное зерно. Диапазон 0–2147483647. Один и тот же prompt и seed дают похожий результат.
string
Негативный промпт для исключения нежелательного содержимого. До 2048 символов.
boolean
по умолчанию:"false"
Генерировать ли аудиодорожку.
  • true: Генерировать аудио (повышает цену)
  • false: Без аудио (по умолчанию)
boolean
по умолчанию:"false"
Добавлять ли водяной знак в правом нижнем углу видео.
  • true: Добавить водяной знак
  • false: Без водяного знака (по умолчанию)
string
Режим движения.
  • normal: Стандартный режим (pixverse-v6 поддерживает только это значение)
fast доступен только для устаревших моделей и будет отклонён сервером для pixverse-v6.
boolean
по умолчанию:"false"
Генерировать ли непрерывное видео из нескольких клипов. Поддерживается только в режимах «текст в видео» и «изображение в видео».
  • true: Генерировать непрерывное многоклиповое видео
  • false: Один клип (по умолчанию)
array<url>
Массив URL входных изображений для режима «изображение в видео». Используется только первое изображение.Изображения должны быть публично доступными HTTP/HTTPS URL.
url
URL первого кадра в режиме перехода. Должен передаваться вместе с last_frame_image.
url
URL последнего кадра в режиме перехода. Должен передаваться вместе с first_frame_image.
array<url>
Массив URL опорных изображений для режима объединения. Поддерживает 1–7 изображений.Передача этого поля активирует режим объединения нескольких опорных изображений.
string
ID исходной задачи для продолжения видео. Передача этого поля активирует режим продолжения.Исходная задача должна принадлежать текущему пользователю, иметь модель pixverse-v6 и статус completed.

Режимы генерации

Адаптер автоматически выбирает режим генерации по полям запроса. Сопоставление выполняется по приоритету: побеждает первый совпавший режим.
Все входы изображений принимают только публично доступные HTTP/HTTPS URL. base64 и Data URI не поддерживаются. Если у вас есть только локальные изображения, сначала загрузите их в объектное хранилище и передайте URL.

Правила параметров

Ответ

integer
Код состояния ответа. При успехе — 200.
array
Возвращаемый массив задач.

Получение результата задачи

Генерация видео — асинхронная задача. После отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата.
cURL
Рекомендуется опрашивать каждые 5 секунд, пока статус не станет completed или failed.

Пример успешного результата

URL видео находится по пути data.result.videos[0].url[0]. Поле url само является массивом. Ссылки обычно действуют 24 часа — заранее скачайте или перенесите файл.

Пример неудачного результата

При неудаче cost обычно равен 0. Причина ошибки — в data.error.message.

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

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

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

Сценарий 3: Переход между первым и последним кадрами

Сценарий 4: Объединение нескольких опорных изображений

Сценарий 5: Продолжение видео