Google: Veo 3.1 Fast
Veo 3.1 Fast — видеомодель Google для коротких сцен по тексту или изображению с генерируемым звуком. Производственный профиль возвращает MP4-клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с, в 720p или 1080p, с управляемыми начальным или конечным кадрами.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Veo 3.1 Fast — быстрый профиль Google для генерации короткой сцены, описанной текстом или заданной изображением. Он объединяет визуальный план с генерируемым звуком и поддерживает управление начальным и конечным кадрами. Используйте его для концепции сцены, коротких творческих вариантов или компактного фрагмента со звуком, понятным действием и визуальным направлением.
Постройте задание вокруг объекта, действия и обстановки. Затем добавьте кадрирование, движение камеры, свет и визуальную обработку, делающие план полезным. Например, небольшая керамическая лампа стоит на деревянном столе, камера медленно приближается, свет включается, и действие сопровождает тихий щелчок выключателя. Объект и событие описывают картинку, указание звука — впечатление слушателя.
Пишите режиссёрские указания на английском, как требует профиль промптов разработчика. Соразмеряйте главное действие с длительностью и различайте движения камеры и объекта. Широкий установочный вид, крупный план текстуры и слежение за движущимся предметом решают разные творческие задачи. Выберите вид, передающий нужную деталь, вместо несвязанных указаний камеры в одном коротком плане.
Для сцены по изображению подготовьте ясную начальную картинку, уже задающую внешность и композицию. Описание движения тогда сосредоточится на последующем событии. Конечный кадр может задавать визуальную цель перехода. Согласуйте важные детали объекта и стиль между кадрами либо явно опишите нужное превращение. Проверяйте сам переход вместе с началом и концом.
Производственный профиль разработчика поддерживает клипы на четыре, шесть или восемь секунд, горизонтальный 16:9 или вертикальный 9:16 и до четырёх выходных видео на промпт. Fast выдаёт 720p или 1080p с частотой 24 кадра/с в MP4. Профиль по изображению принимает JPEG или PNG, указывает максимум 20 МБ и поддерживает конфигурации входа 720p/1080p. Подготовьте композицию под ориентацию и соблюдайте этот предел изображения.
Звук может быть частью создаваемой сцены. Опишите реплику, звук окружения или важный эффект вместе с видимым действием, указывая говорящего и событие, создающее звук. Диалог должен помещаться в нужное исполнение и отличаться от атмосферы или музыки. Генерация звука следует текстовому заданию; аудиозапись не входит в документированные обычные входы этого профиля.
Текущий производственный профиль также перечисляет генерацию по референсам объектов и продление видео. Референсы направляют внешность персонажа или предмета, а граничные кадры — начальную и конечную композиции. Выбирайте материалы с понятной ролью в сцене, не считая все изображения взаимозаменяемыми настройками. Для продолжения используйте отдельный процесс продления и опишите событие после существующего действия; обработка входа отличается от нового плана по тексту.
Негативное описание позволяет обозначить нежелательное содержание или визуальную обработку. Сосредоточьте главный промпт на нужной сцене, а исключения сделайте конкретными для задачи. Для варианта товара сохраняйте объект и кадрирование, меняя одну деталь, например направление света или обработку материала. Сохраняйте настройки и набор референсов при сравнении, чтобы творческая разница оставалась ясной.
Veo 3.1 Fast и обычный профиль Veo 3.1 — разные варианты. Документированный производственный результат Fast — 720p/1080p; обычный профиль также перечисляет 4K. Сохраняйте выбранную версию и настройки результата вместе с материалом, не считая идентификатор Preview или другую версию Veo автоматическим синонимом этого производственного профиля.
Процесс создаёт операцию генерации и предоставляет возвращённые видеофайлы после завершения. Сохраняйте каждый фактический результат, выбранный для проверки, вместе с заданием, исходными кадрами и настройками. Идентификатор операции — запись генерации; готовый MP4 — материал, который можно воспроизвести и использовать в монтаже. Сохраняйте предоставленные метаданные происхождения вместе с видео.
Проверяйте внешность объекта, запрошенное действие, работу камеры и звук во всём ролике. Оценивайте разборчивость диалога и связь звука с событиями до включения в более длинную композицию. Полезным результатом может быть концептуальный план, раскрытие товара или короткий сюжетный фрагмент, к которому титры, переходы и другие правки добавляются в окружающем производственном процессе.
Ailoot Ultra · Видео POST /v1/videos google/veo-3.1-fast
google/veo-3.1-fastНачало
Veo 3.1 Fast — видеомодель Google для коротких сцен по тексту или изображению с генерируемым звуком. Производственный профиль возвращает MP4-клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с, в 720p или 1080p, с управляемыми начальным или конечным кадрами.
- Допустимые входные данные
- Текст
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Видео POST /v1/videos
- Входные данные
text- Результат
video- Выходной формат
- mp4
- Число результатов
- До 4 выходs
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения google/veo-3.1-fast | По умолчанию— |
Поле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-fast"]}, {"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 токенов |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Создавать аудио— | Разрешение— | Расчётная единицаза секунду видео | Условия расчётааудио: with_audio | Плата Выход · Цена видео · Оценка только для сравнения $0.24 за секунду видео |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Создавать аудио— | Разрешение— | Расчётная единицаза секунду видео | Условия расчётааудио: with_audio; разрешение: 4k | Плата Выход · Цена видео · Оценка только для сравнения $0.6 за секунду видео |
| КонфигурацияUltra | Шкала ставок— | Прогноз количестваЗапрошенная конфигурация; только оценка. | Создавать аудиоС аудио | Разрешение720p | Расчётная единицаза секунду выходного видео | Условия расчёта— | Плата Выход · Оценочная секунда выходного видео · Оценка только для сравнения $0.2 за секунду выходного видео Показанная ставка оценивает стоимость до генерации. Итоговая плата рассчитывается по стоимости, записанной для исходной генерации. Физическая длительность видео не является оплачиваемым количеством. |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Создавать аудио— | Разрешение— | Расчётная единицаза секунду видео | Условия расчётааудио: without_audio | Плата Выход · Цена видео · Оценка только для сравнения $0.2 за секунду видео |
| КонфигурацияЦена видео | Шкала ставок— | Прогноз количества— | Создавать аудио— | Разрешение— | Расчётная единицаза секунду видео | Условия расчётааудио: without_audio; разрешение: 4k | Плата Выход · Цена видео · Оценка только для сравнения $0.5 за секунду видео |
| КонфигурацияUltra | Шкала ставок— | Прогноз количестваЗапрошенная конфигурация; только оценка. | Создавать аудиоБез аудио | Разрешение720p | Расчётная единицаза секунду выходного видео | Условия расчёта— | Плата Выход · Оценочная секунда выходного видео · Оценка только для сравнения $0.16 за секунду выходного видео Показанная ставка служит оценкой стоимости до генерации. Итоговое начисление рассчитывается по стоимости, зафиксированной для исходной генерации. Физическая длительность видео не используется как тарифицируемая величина. |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Создавать аудио— | Разрешение— | Расчётная единица— | Условия расчёта— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.64 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Сведения о справочном тарифе
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
Ссылки на цены конфигураций видео
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияЦена видео | Условия расчётааудио: with_audio | Плата Выход · Цена видео $0.24 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётааудио: with_audio; разрешение: 4k | Плата Выход · Цена видео $0.6 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётааудио: without_audio | Плата Выход · Цена видео $0.2 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётааудио: with_audio; разрешение: 720p | Плата Выход · Цена видео $0.2 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётааудио: without_audio; разрешение: 4k | Плата Выход · Цена видео $0.5 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
| КонфигурацияЦена видео | Условия расчётааудио: without_audio; разрешение: 720p | Плата Выход · Цена видео $0.16 за секунду видео Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации. |
Примеры запросов
Ailoot Ultra · Видео
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-fast", "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}/contentGET /v1/videos/generations/{request_id}/content
Проверить статус задачи
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-fast
Псевдонимы путей метода
/v1/videos/generations, /videos, /videos/generations
Связанные ID для вызова
FAQ · Google: Veo 3.1 Fast
- Какие входные данные и результаты доступны?
POST /v1/videos·google/veo-3.1-fast:text→video- Какие поля использует запрос?
POST /v1/videos·google/veo-3.1-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio