Перейти к основному содержанию
POST
Этот эндпоинт работает асинхронно. После отправки используйте полученный task_id в GET /v1/videos/generations/{task_id}, чтобы узнать статус и результат задачи.

Возможности модели

PixVerse V6 Max — версия PixVerse V6 с повышенным качеством изображения. Поддерживается только генерация по тексту и одному изображению, в обоих случаях с именем модели pixverse-v6-max. Для переходов между первым и последним кадрами, объединения нескольких изображений и продления видео используйте PixVerse V6.

Заголовки запроса

string
обязательно
Аутентификация Bearer: Bearer <token>, где <token> — ваш API-ключ APIMart.

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

string
обязательно
Должно быть pixverse-v6-max.
string
Описание содержимого для генерации. Обязательно при генерации по тексту, до 5000 символов; необязательно при генерации по изображению, до 2048 символов.
string[]
Список URL входных изображений. Генерация по изображению принимает ровно 1 изображение; передача 2 и более синхронно возвращает HTTP 400. Для генерации по тексту не передавайте это поле.Изображение должно быть общедоступно по HTTP(S), в формате JPEG, PNG или WebP, размером менее 20 MB, с длиной каждой стороны не более 10000 пикселей.
integer
по умолчанию:"5"
Длительность результата в секундах: от 1 до 15, по умолчанию 5.
string
по умолчанию:"540p"
Разрешение результата: 360p, 540p, 720p или 1080p; по умолчанию 540p.Результат использует нативные размеры модели поставщика; ориентируйтесь на фактически возвращённые размеры. Примеры, наблюдавшиеся в тестах: 640×360 и 1108×832 (ширина × высота, в пикселях).Также принимается поле quality. Если переданы оба поля, приоритет у resolution.
string
Поле совместимости для разрешения с теми же значениями, что у resolution. Используется только при отсутствии resolution; если оба поля не заданы, применяется 540p.
string
по умолчанию:"16:9"
Действует только при генерации по тексту. Поддерживаются 16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 и 21:9; по умолчанию 16:9.При генерации по изображению всегда используется его соотношение сторон; это поле не действует.
boolean
по умолчанию:"false"
Укажите true для генерации нативного звука; по умолчанию видео без звука. Генерация со звуком имеет более высокую цену за секунду.Учитывается только audio на верхнем уровне тела запроса. metadata.generate_audio_switch не включает звук и не активирует тариф со звуком.
integer
Случайное зерно в диапазоне от 0 до 2147483647.

Пример генерации по изображению

Замените пример URL реальным общедоступным адресом изображения. Передайте только 1 изображение; соотношение сторон результата будет соответствовать ему.

Запрос состояния задачи

Замените ID задачи в следующем запросе на task_id, полученный при отправке:

Оплата

Стоимость равна длительности результата в секундах, умноженной на цену за секунду для выбранных разрешения и настройки звука. Для генерации со звуком и без него действуют отдельные тарифы; со звуком цена за секунду выше. Если не заданы ни resolution, ни quality, для результата и оплаты используется 540p. Актуальные цены возвращает эндпоинт цен модели:

Неподдерживаемые функции и ошибки параметров

Следующие запросы синхронно возвращают HTTP 400, без создания задачи и списания средств: