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 家族另有独立低价与高稳定分组可选。

相关文章