Video
PixVerse V6
Создавайте ролики PixVerse V6 на 1–15 секунд из текста, изображения, двух кадров, референсных изображений или готового ролика, от 360p до 1080p, с посекундной оплатой.
PixVerse V6 — видеомодель PixVerse. Один ID модели охватывает пять режимов: текст в видео, изображение в видео, переход между первым и последним кадром, несколько референсных изображений и продление уже созданного ролика. Режим определяется переданными полями. Ролики длятся 1–15 секунд в 360p, 540p, 720p или 1080p, с нативным аудио по желанию. Отправьте запрос, сохраните полученный ID задачи и заберите готовое видео из задачи. Изображения передаются как URL.
ID моделей
| ID модели | Входные данные | Разрешения | Длина |
|---|---|---|---|
pixverse-v6 | текст, одно изображение, первый + последний кадр, 1–7 референсных изображений, выполненная задача pixverse-v6 | 360p, 540p, 720p, 1080p | 1–15 секунд |
Актуальные цены смотрите на странице модели. Если нужен один более детальный план из текста или одного изображения, смотрите PixVerse V6 Max.
Краткий пример
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "16:9"
}'Конечная точка
POST https://api.seedrouter.ai/v1/videos/generations| Заголовок | Значение |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
В ответе приходит задача ({"id": "task_...", "status": "processing"}), а не готовое видео. Результат получайте опросом GET /v1/tasks/{task_id}. Храните API-ключи в серверном коде.
Параметры
| Поле | Тип | По умолчанию | Примечания |
|---|---|---|---|
model | строка | обязательно | pixverse-v6 |
prompt | строка | обязательно | До 5 000 символов. Обязателен в каждом режиме. |
resolution | перечисление | 540p | 360p, 540p, 720p или 1080p. |
duration | целое число | 5 | 1–15 секунд. Переход между первым и последним кадром — только 5 или 8. |
size | перечисление | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 или 21:9. Используется в режимах «текст в видео» и с несколькими референсными изображениями; остальные режимы следуют форме изображений. |
audio | логическое значение | false | Генерация нативного аудио. Оплачивается по тарифу с аудио. |
seed | целое число | нет | 0–2147483647. Одинаковые запрос и зерно дают похожие результаты. |
negative_prompt | строка | нет | Что исключить из ролика. До 2 048 символов. |
watermark | логическое значение | false | Добавить водяной знак. |
motion_mode | перечисление | normal | Поддерживается только normal. |
generate_multi_clip_switch | логическое значение | false | Генерация нескольких планов. Только текст в видео и изображение в видео. |
image_urls | список URL | нет | Изображение в видео. Используется первое изображение. |
first_frame_image | URL | нет | Переход: первый кадр. Передавайте вместе с last_frame_image. |
last_frame_image | URL | нет | Переход: последний кадр. Передавайте вместе с first_frame_image. |
img_references | список URL | нет | Несколько референсных изображений: 1–7 изображений. |
extend_from_task_id | строка | нет | Продление: ID одной из ваших выполненных задач pixverse-v6. |
Схема строгая: неизвестные поля отклоняются, а не игнорируются. callback_url недоступен; вместо этого опрашивайте задачу.
Режимы
Режим определяется переданными полями. В одном запросе передавайте поля одного режима.
| Режим | Что передать | Примечания |
|---|---|---|
| Текст в видео | без полей изображений или продления | size задаёт форму. |
| Изображение в видео | image_urls | Ролик начинается с первого изображения. |
| Переход | first_frame_image + last_frame_image | 5 или 8 секунд. |
| Несколько референсных изображений | img_references (1–7 URL) | Объединяет персонажей, объекты или сцены с изображений; size задаёт форму. |
| Продление | extend_from_task_id | Продолжает вашу выполненную задачу pixverse-v6. |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}Продление возвращает исходный ролик с новым фрагментом в конце, и оплачивается только duration нового фрагмента. В нашем тесте продление ролика на 1 секунду ещё на 1 секунду дало видео длиной 2,1 секунды с оплатой за 1 секунду.
Медиавходы
Изображения — это публичные URL по HTTP(S). Data URI в base64 не принимаются: загрузите файл в собственное хранилище и передайте его URL. Используйте изображения JPG, PNG или WebP размером до 20 МБ.
Факторы стоимости
Актуальные тарифы смотрите в разделе цен модели. PixVerse V6 тарифицируется за секунду видео по тарифу, который зависит от разрешения и генерации аудио:
cost = duration × rate per second for the resolution and audio settingСекунда стоит одинаково во всех режимах; при продлении оплачивается только новый фрагмент. Длительность известна при приёме запроса, поэтому зарезервированная сумма равна списанной. Итоговые списания смотрите в истории использования своей учётной записи. Неуспешные задачи не тарифицируются.
Схема вывода
При отправке возвращается задача:
{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}Получение задачи
GET https://api.seedrouter.ai/v1/tasks/{task_id}Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Сетевой тайм-аут во время опроса не означает, что генерация завершилась сбоем: сохраните идентификатор задачи и продолжите проверку. Не создавайте другую задачу, чтобы узнать ход выполнения.
Выполненная задача
{
"id": "task_...",
"model": "pixverse-v6",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}В наших тестах ролики 360p 16:9 на 1 секунду пришли в MP4 (H.264) с размером 640 × 360 через 36–45 секунд после отправки.
Ошибки
Запросы, отклонённые до создания задачи, возвращают HTTP-ошибку вместе с объектом error и не тарифицируются. Задача, которая завершилась сбоем уже после приёма, при запросе возвращает HTTP 200 с status: "failed" и объектом error.
Коды, HTTP-статусы и рекомендации по повторным попыткам приведены в общем каталоге ошибок.
{
"id": "task_...",
"model": "pixverse-v6",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}Если тайм-аут произошёл при самой отправке, сначала проверьте свои задачи и только потом отправляйте повторно: первый запрос мог быть уже принят.
Советы
- Описывайте объект, место, движение камеры и свет в промпте; указывайте нужные звуки, если
audioвключено. - Делайте черновик в
360pили540p, а затем рендерите финальный план в1080pс тем же запросом иseed. - Для вертикального видео передайте
size: "9:16"в режиме «текст в видео» или вертикальное изображение. - Добавьте
no text, no logos, чтобы в кадре не появлялись выдуманные знаки.
