Введение
PixVerse V6 Text to video превращает письменный бриф в клип длиной от 1 до 15 секунд в 360p, 540p, 720p или 1080p, в восьми соотношениях сторон от 16:9 до 9:16 и 21:9. Опишите субъект, действие и камеру: движения камеры, записанные в промпте, выполняются, а PixVerse заявляет, что V6 понимает из промпта более 20 кинематографических объективов и настроек камеры. Включите generate_audio, и модель вместе с картинкой создаст звук. PixVerse проверяет промпты и изображения до генерации; запросы, которые он отклоняет, завершаются ошибкой и не оплачиваются.
Выберите режим PixVerse V6 по исходному материалу
| Что у вас есть на входе | Режим |
|---|---|
| письменная сцена | PixVerse V6 Text to video (вы здесь) |
| начальный кадр и, при желании, конечный | PixVerse V6 — изображение в видео |
| фото людей, предметов или мест, из которых собирается кадр | PixVerse V6 — референсы в видео |
| клип, который хотите продолжить | PixVerse V6 — продление видео |
| промпт или одно изображение, и нужно более высокое качество картинки | PixVerse V6 Max |
| одно фото и готовый тематический шаблон, промпт писать не нужно | PixVerse V6 Effects |
Ключевые возможности и особенности
Один абзац, несколько планов
В нашем тесте один абзац о смеющейся водительнице винтажного бирюзового кабриолета начинался с крупного плана с развевающимся платком, затем камера поднялась до широкого аэрокадра автомобиля на скальной дороге над океаном. Промпт просил, чтобы дрон отъехал назад и поднялся; переход от крупного плана к аэрокадру сделала модель.
Переключатель многоплановости
shot_type по умолчанию single. Установите multi, и модель сможет разрезать клип на несколько планов. Цену это не меняет.
Восемь соотношений сторон
16:9 (по умолчанию), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 и 21:9. Соотношение сторон цену не меняет.
Звук, когда он нужен
generate_audio по умолчанию выключено. Когда оно включено, модель генерирует атмосферу, эффекты, музыку и любую реплику, которую вы написали в кавычках. Со звуком секунда стоит дороже.
Четыре разрешения
360p, 540p, 720p (по умолчанию) и 1080p. Наш тестовый клип был в 540p, 1024x576, и занял около 41 секунды работы модели на 5 секунд видео.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно, от 3 до 5 000 символов. Опишите субъект, действие и камеру; движения камеры, которые вы указали, выполняются. Не менее 3 символов · Не более 5000 символов |
aspect_ratio | Нет | 16:9 (по умолчанию), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 или 21:9. Цену не меняет. |
resolution | Нет | 360p, 540p, 720p (по умолчанию) или 1080p. Более высокие разрешения стоят дороже за секунду. |
duration_seconds | Нет | Целые секунды от 1 до 15 (по умолчанию 5). Оплата за секунду. |
generate_audio | Нет | По умолчанию выключено. Когда включено, генерирует звук вместе с картинкой: атмосферу, эффекты, музыку и реплики в кавычках. По умолчанию: |
shot_type | Нет | single (по умолчанию) или multi. multi позволяет модели разрезать клип на несколько планов. |
seed | Нет | Необязательное целое число от 0 до 2147483647. Помогает сравнивать запуски при изменении одного параметра; не гарантирует одинаковых кадров. |
Стоимость
Оплата за секунду результата. Разрешение и переключатель звука меняют цену за секунду; соотношение сторон, тип плана и seed — нет. Неудачные и отклонённые запросы не оплачиваются.
| Разрешение | Генерировать аудио: Нет | Генерировать аудио: Да |
|---|---|---|
| $0.0222 / секунду | $0.0311 / секунду |
| $0.0311 / секунду | $0.04 / секунду |
| $0.04 / секунду | $0.0533 / секунду |
| $0.08 / секунду | $0.1022 / секунду |
Сценарии использования
Открывающие и общие планы
Опишите место, свет, одно движение камеры и стиль, и у вас получится кадр, с которого открывается сцена. Наш пример со скальной дорогой сделан именно так, одним абзацем.
Короткие сцены с репликой
Включите звук, опишите действие и поставьте реплику в кавычки. Атмосферу, которую хотите услышать, назовите в том же промпте.
Вертикальный и ультраширокий кадр
Выбирайте 9:16, 3:4 или 2:3 для вертикальных клипов либо 21:9 для ультраширокого. Цена за секунду одинакова для всех соотношений сторон.
Руководство по промптам и практические советы
Пишите в порядке событий
Место и свет сначала, затем субъект и одежда, действие, движение камеры и стиль. Наш пример читается так: золотой час на прибрежном шоссе над обрывом, автомобиль и водитель, дрон отъезжает и поднимается, тёплый стиль плёнки 35 мм.
Пишите движение камеры
Движения камеры, которые вы указали в промпте, выполняются, поэтому называйте их: «the drone pulls back and rises», «slow orbit», «handheld push-in».
Сравнивайте с seed
seed помогает сравнивать запуски, когда вы меняете одну вещь за раз. Он не гарантирует одинаковых кадров.
Сначала черновик, потом финал
Оплата идёт за секунду, и разрешение её меняет, поэтому найдите кадр коротким клипом в меньшем разрешении, а финал рендерите в 720p или 1080p.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.


