GewoonJaap/gemini-cli-openai

解決的問題

本專案提供一個代理層，將 Google 的 Gemini 模型轉換為 OpenAI 相容的端點。這讓使用者能以熟悉的 OpenAI API 模式、SDK 和現有的 AI 客戶端（如 Open WebUI 或 Cline）存取 Gemini 的進階 AI 功能，無需更改應用程式邏輯。

運作方式

以 Cloudflare Worker 的形式部署，作為客戶端與 Google API 之間的橋樑。使用 OAuth2 認證（透過官方 Gemini CLI）存取 Google 的模型，無需傳統的 API 金鑰。它處理 OpenAI 風格的請求與回應轉換，包括支援串流、視覺功能與工具呼叫。

適用對象

希望在僅支援 OpenAI API 格式的工具與應用中使用 Gemini 模型的開發者與 AI 愛好者，或希望透過 Code Assist API 利用 Google 免費方案的使用者。

主要特色

• OpenAI 相容性：可作為 OpenAI 端點的即插即用替代品，支援官方 SDK 與套件。
• OAuth2 認證：使用 Google 帳號認證，而非 API 金鑰。
• 即時串流：支援伺服器傳送事件（SSE）以實現即時回應。
• 高階推理：支援 Gemini 原生的思考能力，可設定推理預算與努力等級。
• 自動模型切換：遇到速率限制時，自動從 Pro 模型降級至 Flash 模型。
• 多模態支援：支援透過 base64 或 URL 傳遞影像的視覺對話。
• 工具呼叫：完全支援 OpenAI 相容的函式呼叫。
• 邊緣部署：透過 Cloudflare Workers 實現全球邊緣部署，降低延遲。