Gemini API 中轉指南：/v1beta 協定與多模態接入

Gemini API Relay Guide

Gemini 協定為什麼難橋接

Gemini 的請求／回應結構（contents、parts、systemInstruction、generationConfig）與 OpenAI 格式差異大；串流格式是獨立的 JSON 行流而非 SSE。很多中轉站只做「OpenAI 格式假裝 Gemini」，導致 function calling、多模態、thinking 欄位相容性問題。

OlithmRouter 在閘道層原生實作 /v1beta 橋接（Caddy 路由＋FastAPI 轉換層＋獨立模型清單三者齊備），generateContent 與 streamGenerateContent 都支援，Gemini CLI 兩個環境變數即可接入。

模型與分組

Gemini 家族：gemini-2.5-flash、3-flash、3.5-flash、3.6-flash、3.8-flash 到 gemini-4-argon，覆蓋快速與高品質檔位；另有語音模型（gemini-3.8-flash-tts）獨立分組計價。分組含低价渠道（0.25×）與高稳定分组（0.5×），價格以控制台為準。

多模態與長上下文

Gemini 的圖片輸入走 inlineData／fileData 結構；透過中轉站使用時注意 base64 大圖會放大請求體（token 換算與流量都是純文字的數十倍）。長上下文場景 Gemini 支援百萬級 token，注意對應的計費跳檔。

接入要點

Gemini CLI：設定 GEMINI_API_KEY=你的 sk- 金鑰＋base_url 指向中轉站即可（OlithmRouter 控制台提供一鍵配置腳本）。SDK：google-genai 改 client options 的 api_base。

常見問題

Gemini CLI 能直接用嗎？

可以。控制台有 Gemini CLI 專屬接入腳本，複製兩行環境變數即可。

function calling 支援嗎？

支援。閘道層做了原生橋接而非簡單轉格式，工具宣告與回覆結構完整傳遞。

跟 OpenAI 格式有什麼不同？

Gemini 原生格式差異大（contents/parts 結構、無 system role、不同串流格式），選中轉站時務必確認是「原生橋接」而非「假相容」。

免費分組有 Gemini 嗎？

免費福利分組清單以控制台顯示為準；Gemini 家族另有独立低价与高稳定分组可選。

相關文章