Nano Banana APIキー：取得・設定・テスト

01OmniaKeyのAPIキーを作成する

サインインしてAPIキー画面を開き、アプリケーション用のキーを作成します。クォータ、有効期限、モデル制限を確認してください。生成リクエストを実行する前に残高を追加します。

02キーとAPI URLを設定する

自分のターミナルでコマンドを実行し、プレースホルダーを自分のキーに置き換えてください。キーはサーバー上またはシークレットマネージャーに保管します。ブラウザのコードや公開リポジトリには絶対に置かないでください。

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03認証を確認する

生成ジョブを開始せずにモデル一覧をリクエストします。成功時のレスポンスはdata配列を含むJSONです。これはキーのアクセスを確認するもので、アカウントですべてのモデルが有効とは限りません。

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04モデルのリクエスト形式を使用する

ファミリーページでモデルを選択し、API IDをコピーして、対応するAPIドキュメントに従ってください。認証だけでは生成パラメータを確認できません。

画像と動画の生成にはPOST /v1/media/tasksを使用します。同じ送信を再試行するときは同じIdempotency-Keyを維持し、返されたタスクIDを保存して、GET /v1/media/tasks/{id}で結果をポーリングしてください。

生成リクエストの例（課金あり）

このリクエストではアカウント残高を使用します。先に選択したモデルの料金を確認してください。この例はドキュメントに沿ったリクエスト形式です。アカウントでモデルを利用できる必要があります。

curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-first-request-001" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "image_size": "1K",
    "aspect_ratio": "1:1"
  }
}'

メディアタスクをポーリングする

YOUR_TASK_IDを作成リクエストで返されたidに置き換えてください。タスクが最終ステータスになるまでポーリングします。成功したタスクでは、assets内のURLが期限切れになる前にダウンロードしてください。新しい冪等キーは新しいタスクにだけ使用してください。

curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"