Gemini API OpenAI compatible アクセスは、2つの異なる移行パスで役立ちます。Google は Gemini 向けに OpenAI 互換エンドポイントを直接ドキュメント化しており、Flatkey は他のモデルに使っている同じ 1 キーのゲートウェイ内で Gemini アクセスを使いたいチーム向けにルーターパスを提供します。
Google の直接パスは、Gemini API キーを使って https://generativelanguage.googleapis.com/v1beta/openai/ にベース URL を切り替えるだけです。Flatkey のパスは OpenAI SDK の形を維持しつつ、クライアントを https://router.flatkey.ai/v1 に向け、Flatkey キーを使用し、テスト前に Flatkey カタログから Gemini のモデル ID を選択して、ログ、コスト、機能サポートを確認します。
このガイドでは、Gemini API OpenAI compatible ルートを安全に使う方法を説明します。Google の互換性ドキュメントが実際に何をサポートしているか、ルーターが運用モデルをどこで変えるのか、そして本番トラフィックを移行する前に何を確認すべきかを取り上げます。
Quick Answer: Gemini API OpenAI Compatible Routing
アプリがすでに OpenAI の Python または JavaScript SDK を使用している場合、Gemini API OpenAI compatible への移行は、書き換えではなく設定変更から始まります。
| Decision | Direct Gemini API | Gemini Through Flatkey |
|---|---|---|
| API key | Google AI Studio の Gemini API key | Flatkey API key |
| Base URL | https://generativelanguage.googleapis.com/v1beta/openai/ |
https://router.flatkey.ai/v1 |
| Primary goal | OpenAI SDK の構文で Gemini を呼び出す | 1つの key の背後で、Gemini を他のモデルプロバイダーと並べてルーティングする |
| Model choice | Google docs の Google Gemini model ID | pricing または dashboard の Flatkey Gemini model ID |
| Validation | Response、model behavior、Google billing | Response、Flatkey usage log、pricing unit、quota、rollback |
Gemini のみが必要で、provider-native な account control を使いたい場合は、直接の Google endpoint を使用してください。Gemini を GPT、Claude、DeepSeek、Qwen、image、video、その他の model access と並べて、1つの key、1つの dashboard、1つの billing surface の背後で扱いたい場合は、Flatkey router を使用してください。
Google の OpenAI 互換ドキュメントが確認していること
Google の OpenAI 互換ドキュメントによると、Gemini モデルは API キー、ベース URL、モデルを更新することで、Python と JavaScript の OpenAI ライブラリに加え、REST からもアクセスできます。ドキュメントに記載されている直接のベース URL は https://generativelanguage.googleapis.com/v1beta/openai/ です。
同じページには、チャット補完、ストリーミング応答、関数呼び出し、画像理解、埋め込みの例も示されています。また、OpenAI 互換のファイルアップロードとダウンロードは現在サポートされていないことも記載されているため、ファイルのワークフローでは完全な OpenAI のファイル互換性を前提にせず、Google GenAI クライアントでの処理が必要です。
これが、あらゆる Gemini API OpenAI compatible ガイドにおける主な教訓です。互換性はエンドポイントと機能ごとに異なります。チャット補完はベース URL の移行だけで済む場合がありますが、ファイルアップロード、画像、バッチ、ツール、埋め込みの各ワークフローは、それぞれ個別にテストする価値があります。
FlatkeyがGeminiセットアップをどう変えるか
Flatkeyでは、最初のテストのためにOpenAI互換アプリを新しいプロバイダーSDKへ置き換えるよう求められません。Flatkeyの公開プロダクト面は、1つのAPIキー、個別のプロバイダーアカウント不要、明確な料金体系、統合請求、そしてキー・利用状況・ルーティングをまとめて確認できる単一ダッシュボードを中心に構築されています。また、OpenAI互換ルーターのベースURLとして https://router.flatkey.ai/v1 を表示しています。
Gemini API OpenAI compatible なルートをFlatkey経由で使う場合、重要なのはOpenAI SDKのメソッド名ではありません。重要なのは運用面です:
- Googleのドキュメントだけでなく、FlatkeyからGeminiのモデルIDを選ぶ。
- リクエスト後に、アプリケーションのレスポンスだけでなくFlatkeyで利用状況とコストを確認する。
- Geminiを他のプロバイダーと同じルーティングおよびクォータのワークフローに保持する。
- チームやツールごとに別々のプロバイダーアカウント経路を作らない。
- ベースURL、キー、モデルを設定で制御し、ロールバックを簡単にする。
この記事用に確認したFlatkeyのライブ料金スナップショットには、Gemini名のカタログ行が含まれていましたが、提供状況や正確なモデル名は変更される可能性があります。カタログは公開日の信頼できる情報源として扱ってください。料金またはダッシュボードでモデルを選び、本番トラフィックの前に正確なモデルIDをテストしてください。
Base URL 移行パターン
まず、移行を3つの環境変数に分けることから始めます:
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_GEMINI_MODEL="replace-with-flatkey-gemini-model-id"これにより、Gemini API OpenAI compatible なクライアントであれば、どれでもクリーンに切り替えられます。アプリのコードは OpenAI 互換の SDK パスを維持し、設定によってリクエストを Google へ直接送るか、Flatkey へ送るか、あるいは別の互換エンドポイントへ送るかが決まります。
| Config Item | Why It Matters | What To Avoid |
|---|---|---|
| Base URL | ルーターの選択をビジネスロジックの外に保ちます。 | 複数のファイルにプロバイダー URL をハードコードすること。 |
| API key | プロバイダーの直接認証情報とルーターの認証情報を分離します。 | 古いプロバイダーキーを Flatkey ルートで再利用すること。 |
| Model ID | Google のモデルを Flatkey カタログのモデルに意図的にマッピングできます。 | すべてのプロバイダーモデルのエイリアスがルーターの背後に存在すると想定すること。 |
| Rollback values | 以前のルートを素早く復元できます。 | ロールバックにコードデプロイが必要になるようにすること。 |
Flatkey Gemini ルーティング用 Python テンプレート
テンプレートのみ: 本番環境で使用する前に、有効な Flatkey キーと確認済みの Flatkey Gemini モデル ID でこれを実行してください。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ["FLATKEY_GEMINI_MODEL"],
messages=[
{
"role": "user",
"content": "Gemini ルートが設定されていることを 1 文で返信してください。",
}
],
)
print(response.choices[0].message.content)
print(response.usage)OpenAI SDK のメソッドはおなじみですが、Flatkey の使用ログにリクエスト、モデル、トークン使用量、ステータス、コストが表示されるまでは、これを完了した Gemini API OpenAI compatible 移行として扱わないでください。
Flatkey Gemini ルーティング用 JavaScript テンプレート
テンプレートのみ: 有効な Flatkey キーと、現在の Flatkey カタログにある確認済みのモデル ID を使用して実行してください。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: process.env.OPENAI_BASE_URL || "https://router.flatkey.ai/v1",
});
const response = await client.chat.completions.create({
model: process.env.FLATKEY_GEMINI_MODEL,
messages: [
{
role: "user",
content: "Reply with one sentence confirming the Gemini route is configured.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);すでに OpenAI 互換の SDK を使用しているチームにとっては、これにより移行を小さく抑えられます。本番対応で重要なのは、機能検証、モデルのマッピング、クォータ、請求の確認です。
本番前の機能チェックリスト
Gemini API OpenAI compatible ルートを本番対応とみなす前に、このチェックリストを使用してください。
| 機能 | Google Docs のシグナル | Flatkey Router の確認 |
|---|---|---|
| 基本的なチャット補完 | OpenAI SDK と REST の例がドキュメント化されている。 | レスポンスと Flatkey の使用ログを確認する。 |
| ストリーミング | Google は OpenAI スタイルの呼び出しによるストリーミングをドキュメント化している。 | ストリーム処理、タイムアウト、部分出力のパースをテストする。 |
| 関数呼び出し | Google は互換性の例を通じてツール/関数呼び出しをドキュメント化している。 | 正確なツールスキーマと tool choice の挙動をテストする。 |
| 画像理解 | Google はチャット補完経由の画像入力をドキュメント化している。 | Flatkey のモデルが、SDK が送信する画像形式を受け入れることを確認する。 |
| 埋め込みとバッチ | Google は埋め込みとバッチ関連の例をドキュメント化している。 | チャット前提ではなく、別のエンドポイントパスとしてテストする。 |
| ファイルのアップロード/ダウンロード | Google は OpenAI 互換のアップロード/ダウンロードは現在サポートされていないと述べている。 | ワークフローがファイルに依存する場合は、別のプロバイダーネイティブなファイル計画を使用する。 |
| 価格 | Google は Gemini Developer API の価格ページを維持している。 | ルーティングされた使用には Flatkey の 価格 を使用し、その後実際のコストログを確認する。 |
Smoke Test Runbook
Gemini API OpenAI compatible のスモークテストでは、API の動作とルーターの可視性の両方を確認する必要があります。
- 現在の Flatkey カタログから Gemini のモデル ID を 1 つ選択します。
- テスト用にリスクの低い Flatkey キーを作成するか選択します。
OPENAI_BASE_URLをhttps://router.flatkey.ai/v1に設定します。- シンプルな非ストリーミングのチャットプロンプトを実行します。
- アシスタントメッセージの形式がアプリのパーサーと一致することを確認します。
- Flatkey の使用ログで、モデル、ステータス、トークン、コストを確認します。
- 不正なモデルのテストを実行し、エラー形式を記録します。
- ストリーミング、ツール呼び出し、画像認識、埋め込みは、アプリで使用している場合のみ実行します。
- 実際のトラフィックを送信する前に、小さなクォータを設定します。
- ロールバック用の設定として、前のプロバイダーの base URL とモデルを保持します。
目的は、単に Gemini の応答を表示させることではありません。目的は、リクエストがどこを通ったのか、いくらかかったのか、失敗時にどのように見えるのか、そしてどれだけ দ্রুতにロールバックできるのかを把握することです。
よくある間違い
- Flatkeyをテストするつもりだったのに、Googleの直接のGemini OpenAI互換ベースURLを使ってしまう。
- Flatkeyのカタログにあるモデル文字列を確認せずにGoogleのモデルIDを使ってしまう。
- ファイルのアップロード/ダウンロードがすべてのOpenAI互換パスで動作すると考えてしまう。
- 本番ではストリーミングやツールを使っているのに、チャット補完だけをテストする。
- 成功したレスポンスの後に利用ログと請求の確認を省略する。
- 本物らしく見えるキーや未テストの本番モデルIDを含むコードスニペットを公開する。
これらは小さな違いですが、Gemini API OpenAI compatible の移行が失敗する主な原因です。ルーターはアクセスを簡単にしますが、正確なリクエスト形式をテストする必要まではなくなりません。
既存のFlatkey移行ガイドとの関係
これが最初のルーター移行であれば、より広範なOpenAI互換API移行ガイドから始めてください。ここでは、どのプロバイダーにも適用されるベースURLパターン、環境変数、スモークテスト、ロールバック、ダッシュボード確認を扱っています。
その後、このGemini固有のガイドでプロバイダー固有の詳細を確認してください。Googleの直接互換エンドポイント、Geminiのモデル選択、機能サポート、ファイル処理の制限です。隣接するモデルアクセスのパターンについては、DeepSeek APIアクセスガイドとClaude APIプロキシ vs ルーターガイドを比較してください。
FAQ
Gemini API は OpenAI 互換ですか？
Google は、OpenAI Python および JavaScript ライブラリと REST の例を通じて、Gemini の OpenAI 互換性を文書化しています。ただし、すべての OpenAI エンドポイントやパラメータが同じ動作をするわけではないため、アプリが使用する正確な機能でテストしてください。
Gemini の OpenAI 直接用ベース URL は何ですか？
Google が文書化している OpenAI 互換の直接ベース URL は https://generativelanguage.googleapis.com/v1beta/openai/ です。Gemini API キーを使って Google に直接接続する場合はこれを使用してください。
Flatkey 経由で Gemini を使う場合、どのベース URL を使えばよいですか？
OpenAI 互換の Flatkey ルートには https://router.flatkey.ai/v1 を使用してください。その後、Flatkey の料金表またはダッシュボードから Gemini モデル ID を選び、本番前にリクエストをテストしてください。
Google のドキュメントにある同じモデル ID を Flatkey で使えますか？
自動的には使えません。モデル文字列と利用可否はカタログやルートによって異なる場合があります。テストする当日の Flatkey でモデル ID を選び、設定に保持してください。
OpenAI 互換ということは、完全に機能が同等という意味ですか？
いいえ。OpenAI 互換とは通常、対応済みエンドポイントで一般的なリクエストとレスポンスの形が動作することを意味します。Google は特に、OpenAI 互換のアップロードとダウンロードは現在サポートされていないと明記しているため、機能レベルでのテストが必要です。
ルーター経由の Gemini 予算はどのように見積もればよいですか？
直接の Gemini 利用に関する文脈には Google の料金ドキュメントを、ルーティング利用には Flatkey の 料金 を使用してください。そのうえで、モデル、キャッシュ、バッチ、モダリティの単位が異なる場合があるため、Flatkey のログで実際のリクエストコストを確認してください。
本番トラフィックをルーティングする前に料金を確認する
Gemini API OpenAI compatible アクセスは、アプリがすでに OpenAI スタイルの SDK 呼び出しを使用している場合の実用的な移行パスです。変更は最小限に抑えましょう。ベース URL を更新し、Flatkey キーを使用し、最新の Gemini モデルを選択し、スモークテストを実行して、本番展開前に使用状況と料金を確認します。
本番トラフィックを送信する前に、料金を確認して、現在の Flatkey Gemini モデルのオプションとコスト単位を確認してください。
