Введение
Текст в видео для Veo 3.1: на входе промпт, на выходе клип 720p длиной 4–8 секунд со сгенерированным звуком.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Видео |
| Издатель | |
| Длина клипа | 4, 6 или 8 секунд |
| Разрешение | 720p: 1280x720 (16:9) или 720x1280 (9:16) |
| Соотношения сторон | 16:9, 9:16 |
| Частота кадров | 24 кадра/с |
| Звук | Создаётся в каждом клипе |
| Входные данные | Текст; первый кадр с необязательным последним |
Ключевые возможности и особенности
Кадр, построенный в том порядке, в котором вы его описали
В промпте попросили открыть купол, появиться телескопу и провести камеру вдоль перил. За 4 секунды в формате 9:16 створка раздвинулась от закрытого положения до полного открытия, внутри загорелся янтарный свет вокруг латунного телескопа, а камера поехала вперёд по изогнутым перилам, именно в таком порядке.
Точно прийти к последнему кадру
Первый кадр: женщина у телескопа спиной к нам. Последний: она опирается на перила, скрестив руки. За 4 секунды она развернулась, подошла к перилам и заняла финальную позу, а над куполом появилось больше звёзд.
Четырёх секунд хватает на одно действие
С одного первого кадра промпт был таким: «He folds the map and looks up.» За 4 секунды он сложил карту обеими руками, но на последнем кадре всё ещё смотрел вниз. Задавайте по одному действию на 4 секунды или выбирайте 8 секунд на два.
Продолжите клип из любой модели
Мы взяли 5-секундный клип, сделанный в другой модели, и попросили добавить 4 секунды: «The road continues along the sea.» Новая часть подхватила воздушный кадр над прибрежной дорогой и проследила за машиной на поворотах. На выходе получился один файл на 9 секунд того же размера, что и исходный клип, а оплачены только 4 новые секунды.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательное поле. Укажите, кто или что в кадре, что происходит, как движется камера и как это звучит; реплики берите в кавычки. Не менее 1 символов · Не более 4000 символов |
aspect_ratio | Нет | 16:9 (по умолчанию, 1280x720) или 9:16 (720x1280). На цену не влияет. |
duration_seconds | Нет | Выберите 4, 6 или 8 секунд (по умолчанию 8). Чем длиннее, тем дороже. |
Стоимость
Оплата один раз за клип по цене его длины в 4, 6 или 8 секунд. Соотношение сторон и звук ничего не добавляют. Запросы, завершившиеся ошибкой или отклонённые, бесплатны.
| Спецификация | Стоимость |
|---|---|
| $1.44 / запрос |
| $2.16 / запрос |
| $2.88 / запрос |
Сценарии использования
Финальный рендер после дешёвого черновика
Отработайте промпт, кадрирование и тайминг на Veo 3.1 Fast за $0.36 или Lite за $0.18 за клип по 4 секунды, а затем отправьте тот же запрос на Veo 3.1 для версии, которую оставите. Все три принимают одинаковые поля.
Предметный или видовой кадр, который должен начинаться и заканчиваться на снимках со съёмки
Передайте начальный и финальный кадр и опишите движение между ними. В нашем тесте клип дошёл до последнего кадра за 4 секунды.
Сцены длиннее 8 секунд
Сгенерируйте первые 8 секунд, затем продолжите их через продление видео: последний кадр клипа открывает новый сегмент в 4–8 секунд, и вы получаете один склеенный файл. Исходный клип длиной до 60 секунд не оплачивается.
Вертикальные клипы со звуком для соцсетей
Выберите 9:16 для клипа 720x1280. Звук создаётся вместе с картинкой, поэтому короткое видео готово без отдельной работы со звуком.
Руководство по промптам и практические советы
Пишите в том порядке, в котором всё происходит
Место и свет, субъект, действие, движение камеры, затем звук. Наш промпт про обсерваторию шёл в таком порядке, и клип проиграл события в той же последовательности.
Ставьте звук как кадр
Напишите, что должно звучать: «Sound: wind over sand, the dome's motor». Произносимые слова берите в кавычки. Google отмечает, что самые короткие реплики пока даются хуже всего, поэтому оставьте сцене с речью несколько секунд.
Согласуйте действие с длиной
Планируйте одно понятное действие на 4 секунды. В нашем тесте с 4 секундами «folds the map and looks up» дошло только до сгиба.
Берегите Veo 3.1 для финального дубля
При одинаковой длине Veo 3.1 стоит вчетверо дороже Fast и в восемь раз дороже Lite. Отработайте формулировку и кадрирование на более дешёвой ступени, а финальный рендер запустите здесь один раз.
Обзор
Veo 3.1 Текст в видео — способ превратить описанную сцену в клип, когда на первом месте качество картинки: верхняя ступень Veo от Google делает 4, 6 или 8 секунд в 720p, в 16:9 или 9:16, и создаёт звук одновременно. Промпты и изображения проходят собственную проверку Google; отклонённый запрос завершается ошибкой и ничего не стоит.
Как выбрать режим Veo 3.1
| Что есть | Что использовать |
|---|---|
| только описанная сцена | Veo 3.1 Текст в видео (вы здесь) |
| статичная картинка для начала или для финала | Veo 3.1 Изображение в видео |
| материал, который нужно продолжить | Veo 3.1 Продление видео |
Советы по промпту
- Стройте промпт как кадр: место и свет, объект, действие, движение камеры, в конце звук.
- Реплики берите в кавычки, а звуковой фон описывайте отдельно.
- Репетируйте на 4 секундах на более дешёвой ступени, а финальный рендер делайте на 8.
Быстрый старт 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": "google/veo-3.1/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"duration_seconds": 8
}
}'
# 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.