模擬Gemini CLI Kiro客戶端請求,與OpenAI API兼容。您每天可以提出數千次Gemini模型請求,並免費使用Kiro內置的Claude模型。通過API輕鬆連接任何客戶端,讓AI開發更高效!
這個項目叫做 AIClient-2-API (by justlovemaki),以下是它的居間+工作原理+使用方法+注意事項,幫助您理解:
1.項目是什麼?
AIClient-2-API是一個代理/適配器工具(用Node.js編寫的HTTP服務),可以「模擬/封裝/代理」多個大型模型接口(如Gemini CLI、Qwen Code Plus、Kiro-Claude等)僅可在客戶端/專有環境中使用,並集成到與OpenAI API兼容的統一接口中。換句話說,如果你有一個當前只支持調用OpenAI格式的API的客戶端/應用/工具,你可以部署這個項目,讓它透明地調用這些其他模型,而不改變客戶端邏輯。
官方REAUTE表示它可以:
- 模擬Gemini CLI、Qwen Code+、Kiro Claude等客戶請求。
- 為客戶或工具提供OpenAI API兼容的接口(遵守OpenAI的請求格式)。
- 每天支持數千個Gemini模型請求;還可以「免費訪問Kiro內置的Claude模型」。
2.核心功能/特徵
以下是它的一些突出功能:
| 功能 | 角色/福利 |
|---|---|
| 多模式統一接入 | 您只需配置模型提供商(Gemini、Claude、Qwen、OpenAI等)通過統一的界面在不同型號之間切換。 |
| OpenAI兼容界面 | 如果客戶端或工具的設計僅支持OpenAI的API,則它也可以直接連接到該服務,無需太大更改。 |
| 帳戶池/投票/故障轉移/降級 | 如果帳戶/代幣出現問題,將自動切換。如果某些型號已獲得許可或服務有限,您還可以對其進行降級。提高可靠性和可用性。 |
| 策略模式的體系結構適配器模式 | 為了方便添加模型提供商;將來自不同服務提供商的API詳細信息脫鉤。 |
| 日誌/提示日誌 | 所有提示都可以被記錄以進行調試、審計,甚至構建您自己的私人數據集。 |
| Docker支持 | 易於部署和隔離環境。 |
3.工作方法/技術細節
簡單來說,它的工作原理是這樣的:
- 部署此服務(本地或雲中)並啟動一個HTTP接口來監聽埠。配置要使用的模型提供程式、OAuth憑據/令牌等。
- 客戶端/工具(假設OpenAI API)將請求發送到AIClient-2-API地址(例如& nbsp;
http://localhost:3000/v1/chat/competitions或類似的路徑)。 - 該服務確認要配置哪個後台模型服務。它可以是OpenAI、Gemini CLI + OAuth或Claude(通過Kiro或通過Claude自己的API)等。
- 將請求轉換為後台服務所需的格式,並處理身份驗證、令牌、型號名稱等
- 收到後台服務的結果後,結果格式(響應體)被轉換為OpenAI接口期望的格式並返回給客戶端。就好像客戶實際上正在調用OpenAI一樣。
還有一些額外的機制,例如:
- 提供帳戶池:提供商可以擁有多個帳戶/憑據,並在一個帳戶出現問題或達到限制時自動切換。
- 請求再試:如果請求失敗,可以自動再試(配置中有相關參數)。
- 系統提示的控制方式:預設、附加、動態等
- 請求日誌:可以保存到文件中。
4.應用場景/適合誰
該計劃適合:
- 如果您有一些客戶端或工具只支持OpenAI界面格式,但您想使用其他型號(Gemini、Claude、Qwen等)並且不想更改客戶端代碼,那麼您可以使用它來「不更改」地切換模型。
- 如果您想要以統一的方式管理多個型號服務提供商的憑據和帳戶,則需要實現高可用性、降低單點限制或提高資源利用率。
- 我想在本地/專用環境中構建一個代理來調試提示、日誌日誌、控制系統提示,或將其用於實驗目的。
- 適合學習/研究/個人/小型項目;在生產環境中使用時,應注意穩定性、安全性、合規性。
5.風險/預防措施
- 合法性/服務條款:一些型號/服務提供商的使用條款可能禁止繞過配額/API限制。此類代理的使用可能會與服務提供商的條款衝突,因此請注意合同/政策問題。
- 安全:您會將API token/OAuth憑據放入配置/文件中,如果使用不當,可能會泄露。收件箱可能會記錄敏感提示/用戶內容,請注意這是否屬於隱私或商業秘密。
- 維穩:因為您依賴多個第三方服務(不同的模型/OAuth流程/供應商政策等),任何地方的變化(例如,OAuth流程更新、API策略更改)可能會導致無效。跟上這些變化。
- 性能延遲:多一層代理將有一點額外的延遲。此外,如果後台模型受到限制/服務速度較慢,也會影響體驗。
- 資源消耗/成本:雖然有「免費」或「高請求配額」的條款,但這些免費配額是有限的,可能會發生變化。大量使用可能需要付費模式/服務。
6.總結
總的來說,AIClient-2-API是一個有用的工具,如果您想在多個模型服務之間切換並擁有統一的調用方法(基於OpenAI的格式),可以為您節省大量兼容性/接口適應。它更傾向於 代理人/中間層的角色 而不是提供模型推斷本身。
Github:https://github.com/justlovemaki/AIClient-2-API
管材: