{ "aboutHtml": "

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. Внешность объекта и поддерживаемая операция зависят от выбранного процесса.

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

", "aboutText": "Veo 3.1 — модель Google для создания короткой сцены со звуком по тексту или заданию на основе изображения. Производственный профиль поддерживает генерацию по тексту, изображению и первому/последнему кадру с генерируемым звуком, референсными материалами и отдельным процессом продолжения. Используйте её для кинематографической концепции, короткой товарной истории или визуального фрагмента с заданными сценой, действием и звуковым впечатлением.\n\nСначала опишите объект и видимое событие. Задайте окружение, время суток и свет, затем точку обзора или движение камеры и визуальный стиль. Авторское задание может показывать стеклянный сосуд на тёмной студийной поверхности, где медленное боковое движение открывает отражение, а раскрытие сопровождает мягкий окружающий звук. Каждая инструкция задаёт видимую или слышимую особенность, которую можно оценить в результате.\n\nПодход Google к промптам разделяет объект, действие, сцену, камеру и эстетику. Используйте части, нужные плану, не добавляя все возможные характеристики. Для документированного профиля пишите указания на английском. Если действий несколько, задайте их связь и соразмерьте с коротким клипом, чтобы появление или реакция оставались понятными.\n\nНачальное изображение задаёт внешность и композицию первого кадра. Используйте его, если персонаж, товар или обстановка уже существуют как визуальный материал, и опишите последующее движение. Последний кадр добавляет целевую конечную композицию. Подготовьте граничные кадры с правдоподобным переходом и сохранением узнаваемых деталей основного объекта, затем проверьте движение между ними после генерации.\n\nРеференсные материалы служат другой цели: направляют внешность персонажа или предмета в новой сцене, тогда как граничные кадры определяют конкретные моменты. Выбирайте референсы, показывающие важные черты, и ясно задавайте роль каждого в промпте. Спецификация производственной модели для генерации видео по референсным изображениям использует восьмисекундный результат для этого процесса, отдельно от обычного выбора длительности по тексту.\n\nОбычный производственный профиль разработчика генерирует клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с. Указаны горизонтальный 16:9 и вертикальный 9:16, до четырёх выходных видео на промпт и разрешения 720p, 1080p и 4K. Формат — MP4. Спецификация по изображению принимает JPEG или PNG, задаёт максимум 20 МБ и поддерживает конфигурации входа 720p/1080p. Выберите профиль результата под размещение, сохраняя читаемость композиции в этом размере.\n\nВстроенный звук может сопровождать сцену. Задавайте реплики, атмосферу и эффекты как части одного задания, называя создающий их объект или событие. Инструкция диалога и инструкция камеры отвечают на разные вопросы: первая задаёт исполнение, вторая — способ показа зрителю. Слова должны укладываться в доступное время речи; проверяйте разборчивость звука и связь с действием.\n\nДля продолжения разработчик предоставляет отдельный процесс продления видео. Начните с подходящего созданного исходного клипа и опишите следующее видимое событие или изменение сцены. Сохраняйте оригинал и продолжение, чтобы проверять их стык на внешность, движение и звук. Обычные варианты длительности и разрешения новой генерации нельзя считать универсальными условиями для каждой операции продления.\n\nНегативное описание помогает сосредоточить исключения на визуальных требованиях задачи. Для серии вариантов товара сохраняйте объект и композицию, меняя одно творческое решение, например свет или дистанцию камеры. Записывайте промпт, референсы и настройки вместе с результатом. Это позволяет сравнивать полезную творческую разницу, а не коллекцию несвязанных генераций.\n\nОбычный производственный Veo 3.1 и Veo 3.1 Fast имеют разные профили разрешения. Fast перечисляет 720p и 1080p, обычная 3.1 — также 4K. Сохраняйте выбранную версию с результатом, не заменяя незаметно производственный идентификатор старым Preview или другим поколением Veo. Внешность объекта и поддерживаемая операция зависят от выбранного процесса.\n\nГенерация — операция, готовый результат которой предоставляет видео для воспроизведения и последующего монтажа. Сохраняйте возвращённые файлы с исходными кадрами, референсными материалами и заданием, а также предоставленные сведения о происхождении. Проверяйте каждый фактический результат на внешность объекта, действие, кадрирование, звук и конечную композицию. Используйте выбранный клип как производственный элемент, добавляя титры, переходы и прочую отделку при монтаже.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a83b875676cd4aab33372bcd885226d63d5c515c4530d5cc12484cac323c64c9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "

G

Google: Veo 3.1

Google /google/veo-3.1

Начало

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

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

О модели

Описание раскрывает возможности модели. Доступные в 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 · входные данные и методы

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 · Видео

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

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

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

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

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

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

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n

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

Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному 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

", "method_identity": { "effective_request_model_id": "google/veo-3.1", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "google/veo-3.1", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|google%2Fveo-3.1", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Keep every completed data[] signed owned URL and the full status metadata. Save every output, including its generated audio.", "errors": [ { "code": null, "condition": "Не удалось прочитать исходное тело запроса до разбора профиля видео", "http_status": 400, "recovery": "Сохраните возвращённый ответ и исправьте нечитаемое тело запроса.", "type": "invalid_request_error" }, { "code": null, "condition": "Не удалось разобрать точный профиль видео либо для полностью разобранного профиля нет готовой точной тарифной карточки", "http_status": 422, "message": "The complete video request cannot be priced", "recovery": "Сохраните ответ; используйте полный точный допущенный профиль и его опубликованную карточку. Эта ветвь выполняется до отправки поставщику.", "type": "price_unavailable" }, { "code": null, "condition": "Содержимое исходного результата пока недоступно", "http_status": 409, "recovery": "Проверяйте исходный возвращённый ID и соблюдайте Retry-After.", "type": "video_not_ready" }, { "code": null, "condition": "Возвращённый ответ указывает, что операция или результат требуют проверки", "http_status": null, "recovery": "Сохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно.", "type": "server_error" }, { "absent_fields": [ "status", "object", "model", "data" ], "code": "result_pending_check", "condition": "GET исходного статуса или содержимого: задача не опубликована, исходная задача не имеет статуса failed/cancelled/expired, а локальное состояние — unknown либо статус исходной задачи — completed.", "friendly_fields": "error.reason=result_pending_check,error.param=null; error.operation_id and error.request_id when the existing context supplies them. error.message is rewritten/localized.", "headers": { "Retry-After": null, "X-Should-Retry": "false" }, "http_status": 503, "recovery": "Сохраните исходные id и operation_id (тот же публичный ID видео), ответ и заголовки; читайте только исходный статус или содержимое. Никогда не отправляйте новый запрос на генерацию.", "response_fields": { "charge_pending_check": true, "error.code": "result_pending_check", "error.type": "server_error", "id": "original public video ID", "operation_id": "same as id" }, "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Проверяйте существующую исходную задачу; никогда не повторяйте отправку с неизвестным исходом.", "unknown_no_replay": true }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_video", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "Use actual returned task_id or original public video id from response/media library. On HTTP503 result_pending_check from original video status/content GET, operation_id equals that original public video id. Do not assume unrelated operation IDs name media tasks.", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_results": "Сохраните каждый подписанный URL готового результата в data[], принадлежащий Ailoot, и все метаданные статуса. Сохраните каждый результат, включая сгенерированное аудио. Корректная аудиодорожка AAC может присутствовать даже при generate_audio=false; сохраняйте исходный MP4 целиком, включая аудио.", "create_status": 202, "family": "video", "fields": [ { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "data[]", "type": "signed content URL" }, { "description": null, "name": "charge_pending_check", "type": "boolean" }, { "description": null, "name": "error.code", "type": "string" }, { "description": null, "name": "error.message", "type": "string" }, { "description": "Ответ исходного статуса или содержимого HTTP503 result_pending_check: в id указан тот же исходный публичный ID видео.", "name": "operation_id", "type": "string" }, { "description": "server_error при HTTP503 result_pending_check.", "name": "error.type", "type": "string" } ], "format": "mp4", "maximum_outputs": 4, "status_enum": [ "in_progress", "completed", "failed" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/veo-3.1" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 6, 8 ], "enum_known": true, "name": "duration", "required": true, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": true, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "all fields outside the exact required six-key profile", "image or reference inputs", "1080p or 4K" ] }, "hints": [ "Сохраните полный ответ и исходные возвращённые ID.", "Никогда не повторяйте создание с неизвестным исходом." ], "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text" ], "parameters": [ { "enum": [ "google/veo-3.1" ], "name": "model", "required": true, "type": "string" }, { "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "enum": [ 4, 6, 8 ], "name": "duration", "required": true, "type": "integer" }, { "enum": [ "720p" ], "name": "resolution", "required": true, "type": "string" }, { "enum": [ "16:9", "9:16" ], "name": "aspect_ratio", "required": true, "type": "string" }, { "enum": [ false, true ], "name": "generate_audio", "required": true, "type": "boolean" } ], "required": [ "model", "prompt", "duration", "resolution", "aspect_ratio", "generate_audio" ] }, "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Read existing original job; never resubmit unknown send.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "operation_modes": [ "text_to_video" ], "output": { "family": "video", "format": "mp4", "max_outputs": 4, "priced_duration": "Video-file duration is not the billing quantity; final charge follows the actual billed configuration." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"google/veo-3.1\", \"prompt\": \"a calm greenhouse\", \"duration\": 6, \"resolution\": \"720p\", \"aspect_ratio\": \"16:9\", \"generate_audio\": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · exact configured profile", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [ "Keep the complete response and the original returned IDs.", "Never resubmit an unknown creation." ], "http": "POST", "in": null, "input": [ "text" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "google/veo-3.1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{request_id}", "GET /v1/videos/generations/{request_id}", "GET /v1/videos/{request_id}/content", "GET /v1/videos/generations/{request_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "google/veo-3.1", "nativeProvenance": { "input_facts_canonical_sha256": "ef0ca2c0a7de18228b29fde722c6c1853e81fc677540d35c30b7cd6d1360d95e", "input_html_sha256": "7dd11c6e416a9f27cc79fa6562513df1995fb169e18ec065756cf7845610b360", "private_audit_sha256": "6ddb78acc7f7240e088a020a68ed2463bb58246a4301a409a31cc161516fbdc7", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ru/google-veo-3-1/", "description": "Veo 3.1 — видеомодель Google для сцен по тексту и изображениям с генерируемым звуком, управляемыми граничными кадрами и референсными материалами. Производственный профиль предоставляет клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с и вариантами разрешения 720p, 1080p и 4K.", "locale": "ru", "md_url": "https://ailoot.ai/models/ru/google-veo-3-1/index.md", "title": "Google: Veo 3.1 — Ailoot", "url": "https://ailoot.ai/models/ru/google-veo-3-1/" }, "rawModel": { "about": "Veo 3.1 — модель Google для создания короткой сцены со звуком по тексту или заданию на основе изображения. Производственный профиль поддерживает генерацию по тексту, изображению и первому/последнему кадру с генерируемым звуком, референсными материалами и отдельным процессом продолжения. Используйте её для кинематографической концепции, короткой товарной истории или визуального фрагмента с заданными сценой, действием и звуковым впечатлением.\n\nСначала опишите объект и видимое событие. Задайте окружение, время суток и свет, затем точку обзора или движение камеры и визуальный стиль. Авторское задание может показывать стеклянный сосуд на тёмной студийной поверхности, где медленное боковое движение открывает отражение, а раскрытие сопровождает мягкий окружающий звук. Каждая инструкция задаёт видимую или слышимую особенность, которую можно оценить в результате.\n\nПодход Google к промптам разделяет объект, действие, сцену, камеру и эстетику. Используйте части, нужные плану, не добавляя все возможные характеристики. Для документированного профиля пишите указания на английском. Если действий несколько, задайте их связь и соразмерьте с коротким клипом, чтобы появление или реакция оставались понятными.\n\nНачальное изображение задаёт внешность и композицию первого кадра. Используйте его, если персонаж, товар или обстановка уже существуют как визуальный материал, и опишите последующее движение. Последний кадр добавляет целевую конечную композицию. Подготовьте граничные кадры с правдоподобным переходом и сохранением узнаваемых деталей основного объекта, затем проверьте движение между ними после генерации.\n\nРеференсные материалы служат другой цели: направляют внешность персонажа или предмета в новой сцене, тогда как граничные кадры определяют конкретные моменты. Выбирайте референсы, показывающие важные черты, и ясно задавайте роль каждого в промпте. Спецификация производственной модели для генерации видео по референсным изображениям использует восьмисекундный результат для этого процесса, отдельно от обычного выбора длительности по тексту.\n\nОбычный производственный профиль разработчика генерирует клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с. Указаны горизонтальный 16:9 и вертикальный 9:16, до четырёх выходных видео на промпт и разрешения 720p, 1080p и 4K. Формат — MP4. Спецификация по изображению принимает JPEG или PNG, задаёт максимум 20 МБ и поддерживает конфигурации входа 720p/1080p. Выберите профиль результата под размещение, сохраняя читаемость композиции в этом размере.\n\nВстроенный звук может сопровождать сцену. Задавайте реплики, атмосферу и эффекты как части одного задания, называя создающий их объект или событие. Инструкция диалога и инструкция камеры отвечают на разные вопросы: первая задаёт исполнение, вторая — способ показа зрителю. Слова должны укладываться в доступное время речи; проверяйте разборчивость звука и связь с действием.\n\nДля продолжения разработчик предоставляет отдельный процесс продления видео. Начните с подходящего созданного исходного клипа и опишите следующее видимое событие или изменение сцены. Сохраняйте оригинал и продолжение, чтобы проверять их стык на внешность, движение и звук. Обычные варианты длительности и разрешения новой генерации нельзя считать универсальными условиями для каждой операции продления.\n\nНегативное описание помогает сосредоточить исключения на визуальных требованиях задачи. Для серии вариантов товара сохраняйте объект и композицию, меняя одно творческое решение, например свет или дистанцию камеры. Записывайте промпт, референсы и настройки вместе с результатом. Это позволяет сравнивать полезную творческую разницу, а не коллекцию несвязанных генераций.\n\nОбычный производственный Veo 3.1 и Veo 3.1 Fast имеют разные профили разрешения. Fast перечисляет 720p и 1080p, обычная 3.1 — также 4K. Сохраняйте выбранную версию с результатом, не заменяя незаметно производственный идентификатор старым Preview или другим поколением Veo. Внешность объекта и поддерживаемая операция зависят от выбранного процесса.\n\nГенерация — операция, готовый результат которой предоставляет видео для воспроизведения и последующего монтажа. Сохраняйте возвращённые файлы с исходными кадрами, референсными материалами и заданием, а также предоставленные сведения о происхождении. Проверяйте каждый фактический результат на внешность объекта, действие, кадрирование, звук и конечную композицию. Используйте выбранный клип как производственный элемент, добавляя титры, переходы и прочую отделку при монтаже.", "alias_of": null, "aliases": [], "author": "Google", "available": null, "canonical_model": "google/veo-3.1", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Полная информация о ценах конфигурации — в подробностях." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "5c12291f0ed9f66144eb670a", "label": "Ссылки на цены конфигураций видео", "profiles": [ { "basis": "Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.", "dimensions": { "conditions": "аудио: with_audio" }, "label": "Цена видео", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.", "dimensions": { "conditions": "аудио: with_audio; разрешение: 4k" }, "label": "Цена видео", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.", "dimensions": { "conditions": "аудио: without_audio" }, "label": "Цена видео", "units": [ { "amount": "0.4", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Опубликованный ориентир цены для показанной конфигурации. Итоговые списания зависят от фактической оплачиваемой конфигурации.", "dimensions": { "conditions": "аудио: without_audio; разрешение: 4k" }, "label": "Цена видео", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "google/veo-3.1", "input": [ "text" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Keep every completed data[] signed owned URL and the full status metadata. Save every output, including its generated audio.", "errors": [ { "code": null, "condition": "Не удалось прочитать исходное тело запроса до разбора профиля видео", "http_status": 400, "recovery": "Сохраните возвращённый ответ и исправьте нечитаемое тело запроса.", "type": "invalid_request_error" }, { "code": null, "condition": "Не удалось разобрать точный профиль видео либо для полностью разобранного профиля нет готовой точной тарифной карточки", "http_status": 422, "message": "The complete video request cannot be priced", "recovery": "Сохраните ответ; используйте полный точный допущенный профиль и его опубликованную карточку. Эта ветвь выполняется до отправки поставщику.", "type": "price_unavailable" }, { "code": null, "condition": "Содержимое исходного результата пока недоступно", "http_status": 409, "recovery": "Проверяйте исходный возвращённый ID и соблюдайте Retry-After.", "type": "video_not_ready" }, { "code": null, "condition": "Возвращённый ответ указывает, что операция или результат требуют проверки", "http_status": null, "recovery": "Сохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно.", "type": "server_error" }, { "absent_fields": [ "status", "object", "model", "data" ], "code": "result_pending_check", "condition": "GET исходного статуса или содержимого: задача не опубликована, исходная задача не имеет статуса failed/cancelled/expired, а локальное состояние — unknown либо статус исходной задачи — completed.", "friendly_fields": "error.reason=result_pending_check,error.param=null; error.operation_id and error.request_id when the existing context supplies them. error.message is rewritten/localized.", "headers": { "Retry-After": null, "X-Should-Retry": "false" }, "http_status": 503, "recovery": "Сохраните исходные id и operation_id (тот же публичный ID видео), ответ и заголовки; читайте только исходный статус или содержимое. Никогда не отправляйте новый запрос на генерацию.", "response_fields": { "charge_pending_check": true, "error.code": "result_pending_check", "error.type": "server_error", "id": "original public video ID", "operation_id": "same as id" }, "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Проверяйте существующую исходную задачу; никогда не повторяйте отправку с неизвестным исходом.", "unknown_no_replay": true }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_video", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "Use actual returned task_id or original public video id from response/media library. On HTTP503 result_pending_check from original video status/content GET, operation_id equals that original public video id. Do not assume unrelated operation IDs name media tasks.", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_results": "Сохраните каждый подписанный URL готового результата в data[], принадлежащий Ailoot, и все метаданные статуса. Сохраните каждый результат, включая сгенерированное аудио. Корректная аудиодорожка AAC может присутствовать даже при generate_audio=false; сохраняйте исходный MP4 целиком, включая аудио.", "create_status": 202, "family": "video", "fields": [ { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "data[]", "type": "signed content URL" }, { "description": null, "name": "charge_pending_check", "type": "boolean" }, { "description": null, "name": "error.code", "type": "string" }, { "description": null, "name": "error.message", "type": "string" }, { "description": "Ответ исходного статуса или содержимого HTTP503 result_pending_check: в id указан тот же исходный публичный ID видео.", "name": "operation_id", "type": "string" }, { "description": "server_error при HTTP503 result_pending_check.", "name": "error.type", "type": "string" } ], "format": "mp4", "maximum_outputs": 4, "status_enum": [ "in_progress", "completed", "failed" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/veo-3.1" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 6, 8 ], "enum_known": true, "name": "duration", "required": true, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": true, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "all fields outside the exact required six-key profile", "image or reference inputs", "1080p or 4K" ] }, "hints": [ "Сохраните полный ответ и исходные возвращённые ID.", "Никогда не повторяйте создание с неизвестным исходом." ], "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text" ], "parameters": [ { "enum": [ "google/veo-3.1" ], "name": "model", "required": true, "type": "string" }, { "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "enum": [ 4, 6, 8 ], "name": "duration", "required": true, "type": "integer" }, { "enum": [ "720p" ], "name": "resolution", "required": true, "type": "string" }, { "enum": [ "16:9", "9:16" ], "name": "aspect_ratio", "required": true, "type": "string" }, { "enum": [ false, true ], "name": "generate_audio", "required": true, "type": "boolean" } ], "required": [ "model", "prompt", "duration", "resolution", "aspect_ratio", "generate_audio" ] }, "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Read existing original job; never resubmit unknown send.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "operation_modes": [ "text_to_video" ], "output": { "family": "video", "format": "mp4", "max_outputs": 4, "priced_duration": "Video-file duration is not the billing quantity; final charge follows the actual billed configuration." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Ориентировочная стоимость генерации", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"google/veo-3.1\", \"prompt\": \"a calm greenhouse\", \"duration\": 6, \"resolution\": \"720p\", \"aspect_ratio\": \"16:9\", \"generate_audio\": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · exact configured profile", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [ "Keep the complete response and the original returned IDs.", "Never resubmit an unknown creation." ], "http": "POST", "in": null, "input": [ "text" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "google/veo-3.1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{request_id}", "GET /v1/videos/generations/{request_id}", "GET /v1/videos/{request_id}/content", "GET /v1/videos/generations/{request_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "google/veo-3.1", "request_model_id": "google/veo-3.1", "route_label": "Ultra" } ], "name": "Google: Veo 3.1", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.6, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "720p" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "1080p" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "1080p" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "4k" }, "label": "Ultra", "units": [ { "amount": "1.20", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "4k" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "basis": "audio=true", "billing_original_currency": "USD", "billing_original_rate": "0.80", "key": "duration_seconds_with_audio", "label": "output second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "1.2", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=4k · audio=true Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "1.20", "key": "duration_seconds_with_audio_4k", "label": "output second", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.40", "key": "duration_seconds_without_audio", "label": "output second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=4k · audio=false Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.80", "key": "duration_seconds_without_audio_4k", "label": "output second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "google/veo-3.1", "short": "Veo 3.1 — видеомодель Google для сцен по тексту и изображениям с генерируемым звуком, управляемыми граничными кадрами и референсными материалами. Производственный профиль предоставляет клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с и вариантами разрешения 720p, 1080p и 4K." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Veo 3.1 — видеомодель Google для сцен по тексту и изображениям с генерируемым звуком, управляемыми граничными кадрами и референсными материалами. Производственный профиль предоставляет клипы на четыре, шесть или восемь секунд с частотой 24 кадра/с и вариантами разрешения 720p, 1080p и 4K.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "be303938922322f23bfdc8323eea644c70f12826c2b865d3c3110a0e718cab66", "renderer_sha256": "aa692ffec412026bdeaf316df24a58e6c5083045e5246f6033f898d132afa5ff" }, "sourceRevision": "83bb6c475537fe49a9e1396530e2ae1087fb8a28959fef3acd9b0ed913a465e4" }