Google: Veo 3.1

Veo 3.1 — видеомодель Google для сцен по тексту и изображениям с генерируемым звуком, управляемыми граничными кадрами и референсными материалами. Производственный профиль предоставляет клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с и вариантами разрешения 720p, 1080p и 4K.

Ailoot Ultra · Видео POST /v1/videos google/veo-3.1

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Veo 3.1 — модель Google для создания короткой сцены со звуком по тексту или заданию на основе изображения. Производственный профиль поддерживает генерацию по тексту, изображению и первому/последнему кадру с генерируемым звуком, референсными материалами и отдельным процессом продолжения. Используйте её для кинематографической концепции, короткой товарной истории или визуального фрагмента с заданными сценой, действием и звуковым впечатлением.

Сначала опишите объект и видимое событие. Задайте окружение, время суток и свет, затем точку обзора или движение камеры и визуальный стиль. Авторское задание может показывать стеклянный сосуд на тёмной студийной поверхности, где медленное боковое движение открывает отражение, а раскрытие сопровождает мягкий окружающий звук. Каждая инструкция задаёт видимую или слышимую особенность, которую можно оценить в результате.

Подход Google к промптам разделяет объект, действие, сцену, камеру и эстетику. Используйте части, нужные плану, не добавляя все возможные характеристики. Для документированного профиля пишите указания на английском. Если действий несколько, задайте их связь и соразмерьте с коротким клипом, чтобы появление или реакция оставались понятными.

Начальное изображение задаёт внешность и композицию первого кадра. Используйте его, если персонаж, товар или обстановка уже существуют как визуальный материал, и опишите последующее движение. Последний кадр добавляет целевую конечную композицию. Подготовьте граничные кадры с правдоподобным переходом и сохранением узнаваемых деталей основного объекта, затем проверьте движение между ними после генерации.

Референсные материалы служат другой цели: направляют внешность персонажа или предмета в новой сцене, тогда как граничные кадры определяют конкретные моменты. Выбирайте референсы, показывающие важные черты, и ясно задавайте роль каждого в промпте. Спецификация производственной модели для генерации видео по референсным изображениям использует восьмисекундный результат для этого процесса, отдельно от обычного выбора длительности по тексту.

Обычный производственный профиль разработчика генерирует клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с. Указаны горизонтальный 16:9 и вертикальный 9:16, до четырёх выходных видео на промпт и разрешения 720p, 1080p и 4K. Формат — MP4. Спецификация по изображению принимает JPEG или PNG, задаёт максимум 20 МБ и поддерживает конфигурации входа 720p/1080p. Выберите профиль результата под размещение, сохраняя читаемость композиции в этом размере.

Встроенный звук может сопровождать сцену. Задавайте реплики, атмосферу и эффекты как части одного задания, называя создающий их объект или событие. Инструкция диалога и инструкция камеры отвечают на разные вопросы: первая задаёт исполнение, вторая — способ показа зрителю. Слова должны укладываться в доступное время речи; проверяйте разборчивость звука и связь с действием.

Для продолжения разработчик предоставляет отдельный процесс продления видео. Начните с подходящего созданного исходного клипа и опишите следующее видимое событие или изменение сцены. Сохраняйте оригинал и продолжение, чтобы проверять их стык на внешность, движение и звук. Обычные варианты длительности и разрешения новой генерации нельзя считать универсальными условиями для каждой операции продления.

Негативное описание помогает сосредоточить исключения на визуальных требованиях задачи. Для серии вариантов товара сохраняйте объект и композицию, меняя одно творческое решение, например свет или дистанцию камеры. Записывайте промпт, референсы и настройки вместе с результатом. Это позволяет сравнивать полезную творческую разницу, а не коллекцию несвязанных генераций.

Обычный производственный Veo 3.1 и Veo 3.1 Fast имеют разные профили разрешения. Fast перечисляет 720p и 1080p, обычная 3.1 — также 4K. Сохраняйте выбранную версию с результатом, не заменяя незаметно производственный идентификатор старым Preview или другим поколением Veo. Внешность объекта и поддерживаемая операция зависят от выбранного процесса.

Генерация — операция, готовый результат которой предоставляет видео для воспроизведения и последующего монтажа. Сохраняйте возвращённые файлы с исходными кадрами, референсными материалами и заданием, а также предоставленные сведения о происхождении. Проверяйте каждый фактический результат на внешность объекта, действие, кадрирование, звук и конечную композицию. Используйте выбранный клип как производственный элемент, добавляя титры, переходы и прочую отделку при монтаже.

Ailoot Ultra · Видео POST /v1/videos google/veo-3.1

google/veo-3.1

Google /google/veo-3.1

Начало

Допустимые входные данные: Текст
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Видео POST /v1/videos

Входные данные: text
Результат: video
Выходной формат: mp4
Число результатов: До 4 выходs

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения google/veo-3.1	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Максимум байтов UTF-8: 10 000 Нужен хотя бы один непробельный символ: Да	По умолчанию—
Поле`duration`	Тип`integer`	ТребованиеОбязательно	Значения и ограничения 4, 6, 8	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеОбязательно	Значения и ограничения 720p	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеОбязательно	Значения и ограничения 16:9, 9:16	По умолчанию—
Поле`generate_audio`	Тип`boolean`	ТребованиеОбязательно	Значения и ограничения false, true	По умолчанию—

Сочетания входных материалов

Из текста в видео · Обязательно: prompt

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Параметр`additional_properties`	Контрактfalse
Параметр`parameters`	Контракт{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]}
Параметр`material_types`	Контрактtext

Псевдонимы метода: /v1/videos/generations, /videos, /videos/generations

Жизненный цикл: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Сохраните полный ответ и исходные возвращённые ID.

Никогда не повторяйте создание с неизвестным исходом.

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Создавать аудио	Разрешение	Расчётная единица	Условия расчёта	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Создавать аудио—	Разрешение—	Расчётная единица—	Условия расчёта—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
КонфигурацияUltra	Шкала ставок—	Прогноз количестваЗапрошенная конфигурация; только оценка.	Создавать аудиоС аудио	Разрешение720p	Расчётная единицаза секунду выходного видео	Условия расчёта—	Плата Выход · Оценочная секунда выходного видео · Оценка только для сравнения $0.8 за секунду выходного видео Показанная ставка служит оценкой стоимости до генерации. Итоговое начисление рассчитывается по стоимости, зафиксированной для исходной генерации. Физическая длительность видео не используется как тарифицируемая величина.
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Создавать аудио—	Разрешение—	Расчётная единицаза секунду видео	Условия расчётааудио: with_audio; разрешение: 4k	Плата Выход · Цена видео · Оценка только для сравнения $1.2 за секунду видео
КонфигурацияUltra	Шкала ставок—	Прогноз количестваЗапрошенная конфигурация; только оценка.	Создавать аудиоБез аудио	Разрешение720p	Расчётная единицаза секунду выходного видео	Условия расчёта—	Плата Выход · Оценочная секунда выходного видео · Оценка только для сравнения $0.4 за секунду выходного видео Показанная ставка служит оценкой стоимости до генерации. Итоговое начисление рассчитывается по стоимости, зафиксированной для исходной генерации. Физическая длительность видео не используется как тарифицируемая величина.
КонфигурацияЦена видео	Шкала ставок—	Прогноз количества—	Создавать аудио—	Разрешение—	Расчётная единицаза секунду видео	Условия расчётааудио: without_audio; разрешение: 4k	Плата Выход · Цена видео · Оценка только для сравнения $0.8 за секунду видео
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Создавать аудио—	Разрешение—	Расчётная единица—	Условия расчёта—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $1.6 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Сведения о справочном тарифе

Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.

Ссылки на цены конфигураций видео

Цены по конфигурациям

Конфигурация	Условия расчёта	Плата
КонфигурацияЦена видео	Условия расчётааудио: with_audio	Плата Выход · Цена видео $0.8 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётааудио: with_audio; разрешение: 4k	Плата Выход · Цена видео $1.2 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётааудио: without_audio	Плата Выход · Цена видео $0.4 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.
КонфигурацияЦена видео	Условия расчётааудио: without_audio; разрешение: 4k	Плата Выход · Цена видео $0.8 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.

Примеры запросов

Ailoot Ultra · Видео

curl · точно по настроенному профилю

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Видео

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Проверить статус задачи

GET статус исходной операции

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Чтение другого содержимого

Сохраняйте каждый готовый результат, принадлежащий вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

Сохраняйте все готовые результаты

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.

Сохраните каждый подписанный URL готового результата в data[], принадлежащий Ailoot, и все метаданные статуса. Сохраните каждый результат, включая сгенерированное аудио. Корректная аудиодорожка AAC может присутствовать даже при generate_audio=false; сохраняйте исходный MP4 целиком, включая аудио.

Если нужно проверить исходный ответ

Проверяйте существующую исходную задачу; никогда не повторяйте отправку с неизвестным исходом.

Максимум результатов: 4.

Поля ответа

Поле	Тип	Значение
Поле`id`	Типstring	Значение—
Поле`object`	Типstring	Значение—
Поле`model`	Типstring	Значение—
Поле`status`	Типstring	Значение—
Поле`data[]`	Типsigned content URL	Значение—
Поле`charge_pending_check`	Типboolean	Значение—
Поле`error.code`	Типstring	Значение—
Поле`error.message`	Типstring	Значение—
Поле`operation_id`	Типstring	ЗначениеОтвет исходного статуса или содержимого HTTP503 result_pending_check: в id указан тот же исходный публичный ID видео.
Поле`error.type`	Типstring	Значениеserver_error при HTTP503 result_pending_check.

Ошибки и дальнейшие шаги

Ответ	Условие	Следующий шаг
Ответ400 · `invalid_request_error`	УсловиеНе удалось прочитать исходное тело запроса до разбора профиля видео	Следующий шагСохраните возвращённый ответ и исправьте нечитаемое тело запроса.
Ответ422 · `price_unavailable`	УсловиеНе удалось разобрать точный профиль видео либо для полностью разобранного профиля нет готовой точной тарифной карточки	Следующий шагСохраните ответ; используйте полный точный допущенный профиль и его опубликованную карточку. Эта ветвь выполняется до отправки поставщику.
Ответ409 · `video_not_ready`	УсловиеСодержимое исходного результата пока недоступно	Следующий шагПроверяйте исходный возвращённый ID и соблюдайте Retry-After.
Ответ`server_error`	УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки	Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно.
Ответ503 · `result_pending_check`	УсловиеGET исходного статуса или содержимого: задача не опубликована, исходная задача не имеет статуса failed/cancelled/expired, а локальное состояние — unknown либо статус исходной задачи — completed.	Следующий шагСохраните исходные id и operation_id (тот же публичный ID видео), ответ и заголовки; читайте только исходный статус или содержимое. Никогда не отправляйте новый запрос на генерацию.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra google/veo-3.1

Псевдонимы путей метода

/v1/videos/generations, /videos, /videos/generations

Связанные ID для вызова

google/veo-3.1

FAQ · Google: Veo 3.1

Какие входные данные и результаты доступны?: POST /v1/videos · google/veo-3.1: text → video
Какие поля использует запрос?: POST /v1/videos · google/veo-3.1: model, prompt, duration, resolution, aspect_ratio, generate_audio

Google: Veo 3.1

Google: Veo 3.1

Начало

Доступно в Ailoot · входные данные и методы

Тарифы

Как рассчитывается итоговая плата

Оценочные ставки для сравнения

Цены по конфигурациям

Сведения о справочном тарифе

Цены по конфигурациям

Примеры запросов

Ailoot Ultra · Видео

Получить и сохранить результаты

Ailoot Ultra · Видео

Проверить статус задачи

Сохраняйте все готовые результаты

Если нужно проверить исходный ответ

Псевдонимы

Псевдонимы моделей

Псевдонимы путей метода

Связанные ID для вызова

Компания и портфель её проектов

Покупайте токены со скидкой.

Подключайте API к продукту, который вы продаёте.