Skip to main content

你將建立的內容

你將傳送一個原生 Gemini POST /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 原生端點:
直接使用原生 Gemini HTTP 請求時,請使用 x-goog-api-key
只有在你的應用程式已經使用聊天補全時,才使用 OpenAI 相容 base URL:

原生 Gemini 格式

原生 Gemini 請求使用 contentspartsgenerationConfig。當你需要 Gemini 專屬欄位時,請使用此路徑,例如 thinking 控制、媒體部分、Google Search grounding,或原生串流運算子。

OpenAI 相容選項

當你正在遷移既有的 OpenAI SDK 或聊天補全應用程式,且不需要 Gemini 原生請求欄位時,請使用 OpenAI 相容路由。

流程說明

不要混用這兩種請求格式。像是 contentsgenerationConfig 這類原生 Gemini 欄位屬於 generateContent 路由。像是 messages 這類聊天補全欄位則屬於 OpenAI 相容路由。

疑難排解 / FAQ

如果你正在建立新的 Gemini 工作流程,請從原生 Gemini generateContent 開始。若既有應用程式已經依賴 OpenAI SDK 或聊天補全請求格式,請使用 OpenAI 相容路由。
請將 contentspartsgenerationConfigstreamGenerateContent 請求傳送到 Gemini 原生端點。OpenAI 相容路由預期的是 messages 與聊天補全參數。
請確認該 model ID 可供你的帳戶使用,且支援你正在呼叫的路由。請使用模型頁面查找目前可用的 model ID。
對於 Google GenAI SDK 請求,請將 base URL 設為 https://api.cometapi.com。對於 OpenAI SDK 請求,請在 Python 中將 base_url 或在 Node.js 中將 baseURL 設為 https://api.cometapi.com/v1

後續步驟