Gemini API を OpenAI 互換形式で呼び出す

Gemini API を直接使うには、Google アカウントで AI Studio にキーを作成し、Google の課金方法で支払います。ここではその部分が入れ替わります。RelaySwitch に前払いし、RelaySwitch のキーを使い、リクエストはゲートウェイを経由して Gemini に届きます。コードから見て変わるのは接続先とキーだけで、モデルは Gemini の ID のままです。

Gemini には独自のリクエスト形式（generateContent）がありますが、既存のツールやコードの多くは OpenAI の Chat Completions 形式で書かれています。Google 自身もそのために OpenAI 互換のインターフェースを提供しており、ドキュメントではこの対応をベータ版としています。RelaySwitch も同じ考え方で、料金表にあるすべての Gemini の ID を OpenAI 形式で呼び出せます。OpenAI 向けに書いたコードを Gemini に切り替えるときに変えるのは、model の値だけです。

単位は米ドル / 100 万トークンで、ページの表示時にカタログから読み込んだ値です。単価は入力、キャッシュ入力、出力の 3 つで、表の料金がそのまま引き落とされます。倍率はありません。

モデル名に preview と付くものはプレビュー版で、Google があとから正式な名前に置き換えます。コードに書く ID は、この表にその時点で載っているものを使ってください。料金の仕組み全体は料金ページにあります。

SDK に組み込む前に、curl でキーと Base URL を確認します。Base URL は /v1 まで含めた https://api.relayswitch.io/v1 で、SDK はその後ろに /chat/completions を付け足します。

ストリーミングは stream を true にすると server-sent events で返り、形式は OpenAI と同じです。

変更するのは base_url、api_key、model の 3 つです。レスポンスの usage に入るトークン数は、そのリクエストの署名付きレシートの記載と一致します。

Google の OpenAI 互換エンドポイント向けに書いたコードは、すでに OpenAI SDK を使っています。移行で変えるのは下の 3 か所で、リクエストボディはそのままです。Google のドキュメントが extra_body で渡している Gemini 固有のフィールドは、このページでは 1 つずつ検証していません。使う場合は先に 1 件送り、レシートの課金が想定どおりか確認してください。

• base_url：Google のドキュメントにあるアドレスから https://api.relayswitch.io/v1 に変えます。
• api_key：AI Studio のキーから、sk-relay- で始まる RelaySwitch のキーに変えます。
• model：料金表と照らして ID を確認します。間違っていると 404 model_not_found が返ります。

Google のリクエスト形式で書かれたプログラムは、書き直さずに使えます。パスは /v1beta/models/{model}:generateContent で、https://api.relayswitch.io の直後に /v1beta が続き、/v1 は付きません。このルートに対応する Gemini の ID で使えます。

キーは x-goog-api-key ヘッダーに入れます。URL のクエリパラメータにキーを書いたリクエストは、ゲートウェイが拒否します。リクエストとレスポンスは Google の構造のままで、contents を送り、candidates が返ります。

エラーもそれぞれの形式に従います。OpenAI 形式では error.code に入り、ネイティブ形式では Google の書き方になります。たとえばキーを付けずに送ると 401 が返り、error.status は UNAUTHENTICATED です。2 つの形式は同じキー、同じ残高を使い、料金も同じです。

Gemini は、契約書の全文、コードリポジトリ、会議の文字起こしといった長い資料を読ませる用途によく使われます。この種のリクエストでは費用のほとんどが入力にかかるので、モデルを選ぶときはまず入力単価とコンテキスト長を見て、その次に出力単価を見ます。同じ資料について繰り返し質問すると、2 回目からは重複する部分がキャッシュにヒットしてキャッシュ入力の単価で課金され、レシートにはそのトークン数が分けて記載されます。

本番環境には専用のキーを作り、米ドルの予算と 1 日の利用上限を設定し、モデルの許可リストで使う Gemini の ID だけに絞ります。長い文書を読むプログラムでは、上限が特に重要です。誤ってディレクトリ全体を送ってしまうと、1 回のリクエストで入力が数十万トークンになります。失敗したリクエストは retry-after ヘッダーを見て、再試行までの待ち時間を決めます。

モデル選びに迷ったら、同じプロンプトを複数の Gemini の ID に 1 回ずつ送り、回答とレシートの料金を比べるのが確実です。OpenAI API（GPT）や Claude API と比べる場合も、変えるのは model の値だけです。

アカウントはメールアドレスで開設し、カード（Apple Pay、Google Pay）または暗号資産（USDT, USDC, BTC, ETH, SOL）で $10 からチャージして、コンソールでキーを作成します。残高は米ドル建てで有効期限はなく、サブスクリプションの契約は不要です。チャージは返金できません。

発行の手順とキーごとの制限は API キーのページに、支払いの詳細は支払い方法にあります。