Перейти к основному содержанию
POST

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

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

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

model
string
обязательно
Название модели генерации видео. Фиксировано: pixverse-v6.
prompt
string
обязательно
Описание содержимого видео, до 5000 символов. Обязателен во всех режимах.
resolution
string
по умолчанию:"540p"
Разрешение видео. Влияет на стоимость.
  • 360p: SD
  • 540p: Стандарт (по умолчанию)
  • 720p: HD
  • 1080p: Full HD
Другие значения разрешения возвращают ошибку параметра.
duration
integer
по умолчанию:"5"
Длительность видео в секундах, диапазон 1–15.
Режим перехода между первым и последним кадрами поддерживает только 5 или 8 секунд.
size
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: Кинематографический широкий
seed
integer
по умолчанию:"0"
Случайное зерно. Диапазон 0–2147483647. Один и тот же prompt и seed дают похожий результат.
negative_prompt
string
Негативный промпт для исключения нежелательного содержимого. До 2048 символов.
audio
boolean
по умолчанию:"false"
Генерировать ли аудиодорожку.
  • true: Генерировать аудио (повышает цену)
  • false: Без аудио (по умолчанию)
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак в правом нижнем углу видео.
  • true: Добавить водяной знак
  • false: Без водяного знака (по умолчанию)
motion_mode
string
Режим движения.
  • normal: Стандартный режим (pixverse-v6 поддерживает только это значение)
fast доступен только для устаревших моделей и будет отклонён сервером для pixverse-v6.
generate_multi_clip_switch
boolean
по умолчанию:"false"
Генерировать ли непрерывное видео из нескольких клипов. Поддерживается только в режимах «текст в видео» и «изображение в видео».
  • true: Генерировать непрерывное многоклиповое видео
  • false: Один клип (по умолчанию)
image_urls
array<url>
Массив URL входных изображений для режима «изображение в видео». Используется только первое изображение.Изображения должны быть публично доступными HTTP/HTTPS URL.
first_frame_image
url
URL первого кадра в режиме перехода. Должен передаваться вместе с last_frame_image.
last_frame_image
url
URL последнего кадра в режиме перехода. Должен передаваться вместе с first_frame_image.
img_references
array<url>
Массив URL опорных изображений для режима объединения. Поддерживает 1–7 изображений.Передача этого поля активирует режим объединения нескольких опорных изображений.
extend_from_task_id
string
ID исходной задачи для продолжения видео. Передача этого поля активирует режим продолжения.Исходная задача должна принадлежать текущему пользователю, иметь модель pixverse-v6 и статус completed.

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

Адаптер автоматически выбирает режим генерации по полям запроса. Сопоставление выполняется по приоритету: побеждает первый совпавший режим.
РежимУсловие активацииОписание
Текст в видеоПоля изображения и продолжения отсутствуютГенерация видео по prompt
Изображение в видеоimage_urls с одним изображениемИспользуется первое изображение
Переход между первым и последним кадрамиУказаны и first_frame_image, и last_frame_imageГенерация плавного перехода между двумя кадрами
Объединение нескольких опорных изображенийУказан массив img_referencesОбъединение 1–7 изображений в видео
Продолжение видеоУказан extend_from_task_idПродолжение из завершённой задачи Pixverse
Все входы изображений принимают только публично доступные HTTP/HTTPS URL. base64 и Data URI не поддерживаются. Если у вас есть только локальные изображения, сначала загрузите их в объектное хранилище и передайте URL.

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

ОграничениеОписание
Длительность1 ≤ duration ≤ 15 секунд; режим перехода поддерживает только 5 или 8 секунд
РазрешениеПоддерживаются только 360p, 540p, 720p, 1080p
Соотношение сторонsize действует только в режимах «текст в видео» и объединения опорных изображений
Длина промптаprompt до 5000 символов, negative_prompt до 2048 символов
Изображение в видеоimage_urls использует только первое изображение
Переходfirst_frame_image и last_frame_image передаются парой
Режим движенияpixverse-v6 поддерживает только normal
Объединение опорных изображенийimg_references поддерживает 1–7 изображений
Продолжение видеоextend_from_task_id должен указывать на завершённую (completed) задачу pixverse-v6 текущего пользователя

Ответ

code
integer
Код состояния ответа. При успехе — 200.
data
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: Продолжение видео