Gemini Omni Video を API で使う方法

Gemini Omni Flash は Google の手頃なテキスト→動画モデルです。Hypereal からシンプルな REST API で利用でき、テキストプロンプトから 720P 動画クリップを生成します。サブスクリプションも専用クライアントライブラリも不要です。

主なスペック：

• 解像度: 720P
• 尺: 6 秒または 10 秒
• アスペクト比: 16:9（横）または 9:16（縦）
• 音声なし — 映像のみ
• 価格: 1 本 $0.1725（従量課金、定額）

新規アカウントには無料クレジットが付与されるため、費用をかける前にエンドポイントを試せます。

1. Hypereal の無料アカウントと API キーを作成

hypereal.cloud で登録し、Dashboard の Manage API Keys から API キーを作成します。

環境変数に保存してください：

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、モバイル向け・縦型 SNS コンテンツには 9:16 を使用します。

4. 結果をポーリングで取得

生成は通常 30〜90 秒で完了します。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);
  }
}

価格

モデル	1 本あたりの価格	尺の選択肢	解像度
gemini_omni_flash	$0.1725	6 秒または 10 秒	720P

課金は従量制 — 秒単位ではなく 1 クリップごとの課金です。10 秒クリップも 6 秒クリップも同じ料金です。このモデルを使うための月額サブスクリプションは不要です。

無料クレジットで最初の数クリップを生成できます。大量に使う場合はダッシュボードから一般クレジットをチャージしてください。

Gemini Omni Flash を使うべき場面

以下のユースケースに適しています：

• 短いプロダクトデモやコンセプト動画 — 6 秒クリップはランディングページや広告に最適
• プロトタイピング — $0.17/本という価格でプロンプトを繰り返し試せる
• 縦型 SNS コンテンツ — 9:16 モードはそのまま Reels や Shorts に使える
• バッチパイプライン — 定額課金のため自動化ワークフローのコスト見積もりが簡単

長尺クリップや音声が必要な場合は、Hypereal の Veo 3.1 エンドポイントを検討してください。Gemini Omni Flash の強みは、大量の 720P クリップを素早く低コストで生成することです。