Gemini 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ドキュメントに従ってください。認証だけでは生成パラメータを確認できません。

クライアントは、選択したモデルが使用するプロトコルに対応している必要があります。Chat Completions、Responses、プロバイダー固有のエンドポイントを切り替える前に、モデルのドキュメントを確認してください。

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

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

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'