Google Video API

На этой странице описан вызов видеомоделей Google veo-3.1, veo-3.1-fast, gemini-omni-flash и gemini-omni-flash-1.1. Как и другие видеомодели, они создаются через POST /v1/videos и опрашиваются через GET /v1/videos/{id}; аутентификация, загрузка материалов, статусы опроса, скачивание результатов и обработка ошибок описаны в полной спецификации Video API. Здесь приведены только поля и правила, специфичные для видеомоделей Google.

Обновлено 2026-10-10. Новые запросы к видеомоделям Google используют только опрос; не указывайте callback_url.

Модели

Общие правила

• Соотношение сторон: ratio (или aspect_ratio) принимает только 16:9 и 9:16; по умолчанию 16:9.
• Разрешение: resolution принимает 720p, 1080p или 4k; по умолчанию 720p. Запрос 360p генерируется и оплачивается как 720P.
• size: одним полем можно задать и разрешение, и соотношение сторон, например 1280x720, 1080x1920, 3840x2160; можно указать и только соотношение 16:9 или 9:16. Противоречащие друг другу значения size, ratio и resolution вернут 400.
• Количество: каждый запрос создаёт одно видео; n может быть только 1.
• Изображения: не более 20 МиБ на изображение, в одном из видов:
  • публичный HTTPS URL (рекомендуется);
  • Data URI, например data:image/png;base64,...;
  • Base64 PNG, JPEG или WebP без префикса;
  • файл multipart/form-data в поле input_reference, image, images, first_frame или last_frame.
• Форматы изображений: Veo принимает только JPEG и PNG; Gemini Omni — PNG, JPEG и WebP.
• Видео: только публичные HTTPS URL, формат MP4, MOV или WebM, не более 64 МиБ. Локальное видео сначала загрузите, как описано в разделе Загрузка локальных файлов, затем передайте полученный url в video. Data URI, Base64 и видеофайлы в multipart не принимаются.
• Поле референсного видео: используйте video или videos верхнего уровня, а не metadata.referenceVideos. Ни одна видеомодель Google не принимает референсное аудио.
• Результат: после завершения video_url — это адрес MP4 на assets.88api.ai. Его можно скачать напрямую или передать как video в последующий запрос на продление или редактирование.

Veo 3.1 / Veo 3.1 Fast

• metadata.video_mode позволяет явно выбрать frames (первый кадр или первый и последний кадр) или reference (референсные изображения). task может также быть text_to_video, image_to_video, reference_to_video или extend; противоречащие значения вернут 400.
• generate_audio (или metadata.generateAudio) по умолчанию true и генерирует нативный синхронный звук; при false видео не содержит звуковой дорожки. Генерация звука не влияет на цену.
• negative_prompt (не более 2000 символов) и seed (0–4294967295) можно указать на верхнем уровне или как metadata.negativePrompt и metadata.seed.
• Входное видео для продления должно быть MP4 длительностью 1–30 секунд; оплачиваются добавленные секунды, то есть длительность результата минус длительность входа.
• Veo не поддерживает референсное видео, референсное аудио, temperature и top_p.

Текст в видео в 4K:

{
  "model": "veo-3.1",
  "prompt": "Серебристый спорткар в дождливом ночном городе, съёмка с низкой точки в движении, отражения неона, кинематографично",
  "duration": 8,
  "resolution": "4k",
  "ratio": "16:9",
  "generate_audio": true
}

Первый и последний кадр (два изображения — по порядку первый и последний кадр):

{
  "model": "veo-3.1-fast",
  "prompt": "Плавный переход от пустой площади ранним утром к той же композиции ночью, когда зажигаются огни",
  "duration": 6,
  "size": "1920x1080",
  "images": [
    "https://cdn.example.com/start.jpg",
    "https://cdn.example.com/end.jpg"
  ],
  "metadata": {
    "negativePrompt": "blur, distortion"
  }
}

Референсные изображения (фиксированно 8 с):

{
  "model": "veo-3.1",
  "prompt": "Сохранить лицо и одежду персонажа с референсных изображений, он медленно идёт по берегу моря",
  "duration": 8,
  "images": [
    "https://cdn.example.com/character-front.jpg",
    "https://cdn.example.com/character-side.jpg"
  ],
  "metadata": {
    "video_mode": "reference"
  }
}

Продление видео:

{
  "model": "veo-3.1",
  "prompt": "Продолжить текущий кадр, человек идёт дальше вперёд",
  "task": "extend",
  "video": "https://assets.88api.ai/media/task-videos/2026/10/example.mp4"
}

Загрузка локального изображения как первого кадра (metadata передаётся строкой JSON):

curl --request POST 'https://api.88api.ai/v1/videos' \
  --header 'Authorization: Bearer sk-xxxx' \
  --form 'model=veo-3.1-fast' \
  --form 'prompt=Медленный наезд камеры, облака на заднем плане естественно плывут' \
  --form 'seconds=8' \
  --form 'size=1280x720' \
  --form 'metadata={"video_mode":"frames"}' \
  --form 'input_reference=@start.jpg;type=image/jpeg'

Gemini Omni Flash / Gemini Omni 1.1

Если task не указан, тип задачи определяется переданными материалами:

• task можно также явно задать как text_to_video, image_to_video, reference_to_video, edit или extend.
• В отличие от Veo, два изображения в images считаются референсными; для первого и последнего кадра используйте first_frame и last_frame.
• Поля первого и последнего кадра нельзя сочетать с обычными референсными изображениями.
• gemini-omni-flash выдаёт только 720P и не поддерживает редактирование и продление видео; его референсное видео нужно передавать вместе с референсными изображениями.
• gemini-omni-flash-1.1 принимает до 10 референсных изображений и 3 референсных видео.
• Редактирование видео (1.1): передайте 1 видео в video и опишите нужное изменение в промпте. Не передавайте ratio, aspect_ratio и size: соотношение сторон исходного видео сохраняется. resolution указать можно.
• Продление видео (1.1):
  • Передайте task: "extend" и 1 video; не передавайте duration, ratio и size.
  • Каждое продление добавляет около 10 секунд; resolution принимает 720p (по умолчанию) или 1080p, 4K не поддерживается.
  • Вход должен быть MP4 длительностью 1–30 секунд. Для более длинного видео сначала вырежьте концовку (рекомендуется 10 секунд) и продлевайте этот фрагмент.
  • Оплачиваются добавленные секунды, то есть длительность результата минус длительность входа. Можно передать input_duration (длительность входного видео в секундах); если она отличается от измеренной более чем на 0,1 секунды, запрос будет отклонён.
• Результат продления — полный MP4, в котором входная часть перегенерирована моделью: она похожа на оригинал, но не является покадровой копией. При монтаже сохраните оригинал целиком и добавьте после него только ту часть результата, которая идёт после длительности входа.
• temperature (0–2) и top_p (0–1) необязательны. У Gemini Omni нет переключателя генерации звука.

Генерация по первому кадру (Flash):

{
  "model": "gemini-omni-flash",
  "prompt": "Медленный наезд камеры, от выпечки поднимается пар",
  "duration": 5,
  "ratio": "9:16",
  "image": "https://cdn.example.com/start.jpg"
}

Референсные изображения и референсное видео (1.1, 4K):

{
  "model": "gemini-omni-flash-1.1",
  "prompt": "Сохранить ритм камеры из референсного видео и заменить объект на продукт с изображения",
  "duration": 8,
  "resolution": "4k",
  "images": ["https://cdn.example.com/product.jpg"],
  "video": "https://cdn.example.com/reference.mp4"
}

Продление видео (1.1):

{
  "model": "gemini-omni-flash-1.1",
  "prompt": "Продолжить текущую сцену, рябь естественно расходится по воде",
  "task": "extend",
  "resolution": "1080p",
  "video": "https://assets.88api.ai/media/task-videos/2026/10/example.mp4"
}