Как использовать Gemini Omni Video через API

Gemini Omni Flash — это доступная модель Google для генерации видео из текста, доступная на Hypereal через простой REST API. Модель создаёт 720P видеоклипы по текстовому промпту — без подписки и без специальных клиентских библиотек.

Основные характеристики:

• Разрешение: 720P
• Длительность: 6 или 10 секунд
• Соотношение сторон: 16:9 (горизонтальное) или 9:16 (вертикальное)
• Без аудио — только видео
• Цена: $0,1725 за клип (фиксированная, оплата по факту использования)

Новые аккаунты получают бесплатные кредиты, поэтому вы можете протестировать эндпоинт до любых расходов.

Шаг 1: Создайте бесплатный аккаунт и API-ключ на Hypereal

Зарегистрируйтесь на hypereal.cloud, откройте панель управления и перейдите в Manage API Keys для создания ключа.

Сохраните его как переменную окружения:

export HYPEREAL_API_KEY="ck_..."

Шаг 2: Сгенерируйте первое видео

Отправьте POST-запрос к эндпоинту генерации видео с вашим промптом и параметрами:

curl -X POST https://hypereal.cloud/api/v1/videos/generate \
  -H "Authorization: Bearer $HYPEREAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini_omni_flash",
    "prompt": "a white cube rotating on a black background, clean product demo",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "720P"
  }'

API возвращает ID задачи и URL для опроса:

{
  "jobId": "job_abc123",
  "pollUrl": "https://hypereal.cloud/api/v1/jobs/job_abc123"
}

Генерация видео выполняется асинхронно. Сохраните pollUrl и используйте его на следующем шаге для получения результата.

Шаг 3: Параметры — duration, resolution и aspect_ratio

Параметр	Допустимые значения	Примечания
model	gemini_omni_flash	Обязательный
prompt	любая строка	Описание содержимого видео
duration	6 или 10	В секундах; по умолчанию 6
resolution	720P	Единственное поддерживаемое разрешение
aspect_ratio	16:9 или 9:16	Горизонтальное или вертикальное

Используйте 16:9 для демо продуктов, сцен и горизонтальных съёмок. Используйте 9:16 для мобильного контента и вертикальных роликов в соцсетях.

Шаг 4: Опрос для получения результата

Генерация обычно завершается за 30–90 секунд. Опрашивайте URL задачи, пока status не станет "completed":

curl https://hypereal.cloud/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $HYPEREAL_API_KEY"

Ответ по завершении:

{
  "jobId": "job_abc123",
  "status": "completed",
  "output": {
    "url": "https://cdn.hypereal.cloud/videos/job_abc123.mp4"
  }
}

Поле url содержит прямую ссылку на готовый MP4-файл. Скачайте его или встройте напрямую.

Простой цикл опроса на Node.js:

const delay = ms => new Promise(r => setTimeout(r, ms));

async function waitForVideo(jobId, apiKey) {
  const pollUrl = `https://hypereal.cloud/api/v1/jobs/${jobId}`;
  while (true) {
    const res = await fetch(pollUrl, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const data = await res.json();
    if (data.status === 'completed') return data.output.url;
    if (data.status === 'failed') throw new Error('Generation failed');
    await delay(5000);
  }
}

Цены

Модель	Цена за клип	Варианты длительности	Разрешение
gemini_omni_flash	$0,1725	6 с или 10 с	720P

Биллинг по факту использования — оплата за клип, а не за секунду. 10-секундный клип стоит столько же, сколько 6-секундный. Месячная подписка для использования этой модели не требуется.

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

Когда использовать Gemini Omni Flash

Gemini Omni Flash подходит, когда вам нужны:

• Короткие демо продукта или концепции — 6-секундные клипы хорошо работают для лендингов и рекламы
• Прототипирование — за $0,17/клип можно итерировать промпты без затрат на премиум-модели
• Вертикальный контент для соцсетей — режим 9:16 сразу готов для Reels и Shorts без кадрирования
• Пакетные пайплайны — фиксированная цена упрощает расчёт стоимости для автоматизированных рабочих процессов

Для более длинных клипов или сцен с аудио посмотрите на эндпоинты Veo 3.1 на Hypereal. Сильная сторона Gemini Omni Flash — быстрая и доступная генерация 720P клипов в большом объёме.