作成するもの
ネイティブな GeminiPOST /v1beta/models/\{model\}:generateContent リクエストを送信し、その後、すでにチャット補完のリクエスト形式を使っているアプリ向けの OpenAI 互換 POST /v1/chat/completions オプションと比較します。
前提条件
COMETAPI_KEYに保存された CometAPI API キー- Models page の Gemini テキスト model ID
curl、Python 3.10+、または Node.js 18+
API キー、base URL、認証
Gemini のリクエストフィールドを使いたい場合は、Gemini ネイティブエンドポイントを使用します:x-goog-api-key を使用します:
ネイティブ Gemini 形式
ネイティブ Gemini リクエストではcontents、parts、generationConfig を使用します。thinking controls、メディアパート、Google Search grounding、またはネイティブのストリーミング演算子のような Gemini 固有フィールドが必要な場合は、このパスを使います。
OpenAI 互換オプション
既存の OpenAI SDK またはチャット補完アプリを移行していて、Gemini ネイティブのリクエストフィールドが不要な場合は、OpenAI 互換ルートを使用します。フローの説明
2 つのリクエスト形式を混在させないでください。
contents や generationConfig のようなネイティブ Gemini フィールドは generateContent ルートで使用します。messages のようなチャット補完フィールドは OpenAI 互換ルートで使用します。
トラブルシューティング / FAQ
どのパスから始めるべきですか
どのパスから始めるべきですか
新しい Gemini ワークフローを構築する場合は、ネイティブ Gemini の
generateContent から始めてください。既存アプリがすでに OpenAI SDK またはチャット補完のリクエスト形式に依存している場合は、OpenAI 互換ルートを使用します。ネイティブ Gemini フィールドがチャット補完で失敗する
ネイティブ Gemini フィールドがチャット補完で失敗する
contents、parts、generationConfig、および streamGenerateContent リクエストは Gemini ネイティブエンドポイントに送信してください。OpenAI 互換ルートは messages とチャット補完パラメータを想定しています。Gemini model ID が失敗する
Gemini model ID が失敗する
その model ID があなたのアカウントで利用可能であり、呼び出しているルートをサポートしていることを確認してください。現在の model ID を確認するには Models page を使用してください。
SDK が誤ったサービスを指している
SDK が誤ったサービスを指している
Google GenAI SDK リクエストでは、base URL を
https://api.cometapi.com に設定します。OpenAI SDK リクエストでは、Python の base_url または Node.js の baseURL を https://api.cometapi.com/v1 に設定します。次のステップ
generateContentの完全なリクエストフィールドとレスポンスフィールドについては、Gemini ネイティブ API リファレンス を使用してください。- OpenAI 互換のリクエスト形式については、チャット補完 API リファレンス を参照してください。
- OpenAI SDK クライアントは OpenAI SDK で CometAPI を使う で設定してください。
- 利用可能なモデルは 利用可能な CometAPI モデルを一覧表示する で確認できます。
- リトライとレート制限処理は エラーコードとリトライ戦略 で追加してください。