Skip to main content

作成するもの

ネイティブな Gemini POST /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 ネイティブエンドポイントを使用します:
Gemini ネイティブの直接 HTTP リクエストでは x-goog-api-key を使用します:
アプリケーションがすでにチャット補完を使っている場合にのみ、OpenAI 互換の base URL を使用します:

ネイティブ Gemini 形式

ネイティブ Gemini リクエストでは contentspartsgenerationConfig を使用します。thinking controls、メディアパート、Google Search grounding、またはネイティブのストリーミング演算子のような Gemini 固有フィールドが必要な場合は、このパスを使います。

OpenAI 互換オプション

既存の OpenAI SDK またはチャット補完アプリを移行していて、Gemini ネイティブのリクエストフィールドが不要な場合は、OpenAI 互換ルートを使用します。

フローの説明

2 つのリクエスト形式を混在させないでください。contentsgenerationConfig のようなネイティブ Gemini フィールドは generateContent ルートで使用します。messages のようなチャット補完フィールドは OpenAI 互換ルートで使用します。

トラブルシューティング / FAQ

新しい Gemini ワークフローを構築する場合は、ネイティブ Gemini の generateContent から始めてください。既存アプリがすでに OpenAI SDK またはチャット補完のリクエスト形式に依存している場合は、OpenAI 互換ルートを使用します。
contentspartsgenerationConfig、および streamGenerateContent リクエストは Gemini ネイティブエンドポイントに送信してください。OpenAI 互換ルートは messages とチャット補完パラメータを想定しています。
その model ID があなたのアカウントで利用可能であり、呼び出しているルートをサポートしていることを確認してください。現在の model ID を確認するには Models page を使用してください。
Google GenAI SDK リクエストでは、base URL を https://api.cometapi.com に設定します。OpenAI SDK リクエストでは、Python の base_url または Node.js の baseURLhttps://api.cometapi.com/v1 に設定します。

次のステップ