你將建立的內容
你將傳送一個原生 GeminiPOST /v1beta/models/\{model\}:generateContent 請求,接著將它與 OpenAI 相容的 POST /v1/chat/completions 選項進行比較,適用於已經使用聊天補全請求格式的應用程式。
先決條件
- 儲存在
COMETAPI_KEY中的 CometAPI API key - 來自模型頁面的 Gemini 文字模型 model ID
curl、Python 3.10+ 或 Node.js 18+
API key、base URL、驗證
當你想使用 Gemini 請求欄位時,請使用 Gemini 原生端點:x-goog-api-key:
原生 Gemini 格式
原生 Gemini 請求使用contents、parts 和 generationConfig。當你需要 Gemini 專屬欄位時,請使用此路徑,例如 thinking 控制、媒體部分、Google Search grounding,或原生串流運算子。
OpenAI 相容選項
當你正在遷移既有的 OpenAI SDK 或聊天補全應用程式,且不需要 Gemini 原生請求欄位時,請使用 OpenAI 相容路由。流程說明
不要混用這兩種請求格式。像是
contents 和 generationConfig 這類原生 Gemini 欄位屬於 generateContent 路由。像是 messages 這類聊天補全欄位則屬於 OpenAI 相容路由。
疑難排解 / FAQ
我應該從哪一種路徑開始
我應該從哪一種路徑開始
如果你正在建立新的 Gemini 工作流程,請從原生 Gemini
generateContent 開始。若既有應用程式已經依賴 OpenAI SDK 或聊天補全請求格式,請使用 OpenAI 相容路由。原生 Gemini 欄位在 Chat Completions 上失敗
原生 Gemini 欄位在 Chat Completions 上失敗
請將
contents、parts、generationConfig 和 streamGenerateContent 請求傳送到 Gemini 原生端點。OpenAI 相容路由預期的是 messages 與聊天補全參數。Gemini model ID 失敗
Gemini model ID 失敗
請確認該 model ID 可供你的帳戶使用,且支援你正在呼叫的路由。請使用模型頁面查找目前可用的 model ID。
SDK 指向錯誤的服務
SDK 指向錯誤的服務
對於 Google GenAI SDK 請求,請將 base URL 設為
https://api.cometapi.com。對於 OpenAI SDK 請求,請在 Python 中將 base_url 或在 Node.js 中將 baseURL 設為 https://api.cometapi.com/v1。後續步驟
- 使用 Gemini 原生 API 參考 查看完整的
generateContent請求與回應欄位。 - 閱讀聊天補全 API 參考以了解 OpenAI 相容的請求格式。
- 在 搭配 OpenAI SDK 使用 CometAPI 中設定 OpenAI SDK 用戶端。
- 使用 列出可用的 CometAPI 模型 列出可用模型。
- 使用 錯誤代碼與重試策略 加入重試與速率限制處理。