Gemini API 支持文本、图片、音频、视频等多模态输入，价格相对友好。但国内访问 Google 服务、配额限制和付款方式，仍然是常见门槛。
Gemini API 中转就是把这层访问和计费收口到一个网关。本文讲清楚怎么选、怎么接、怎么测试。
说明：Gemini、Google 是其权利人的商标。本文仅用于技术讨论，价格和接口以官方/站内为准。
一、Gemini API 中转是什么
你的应用 → 中转网关 → Google Gemini
你仍然调用 Gemini 模型，只是 Base URL、Key 换成网关的。网关负责鉴权、计费、日志和通道切换。
二、适合谁
- 国内访问 Google 不稳定。
- 需要多模态能力（图片/视频/音频）。
- 需要统一账单、成员和额度。
- 同时用 Gemini、Claude、GPT、DeepSeek 的团队。
- 需要快速切模型做 A/B 测试。
三、选型指标
| 指标 | 要确认什么 |
|---|---|
| 模型覆盖 | Pro/Flash 等版本是否齐全 |
| 多模态 | 图片/视频/音频输入是否支持 |
| 协议 | OpenAI 兼容是否完整；流式/工具调用是否正常 |
| 稳定性 | 错误率、P95、限流 |
| 计费 | 输入/输出/多模态怎么算 |
| 额度 | Key/成员/项目限额 |
| 合规 | 数据保留、合同、发票 |
四、配置方式
Base URL：
https://ai.zhongshangqihang.com/v1
curl：
export GEMINI_API_KEY="sk-你的密钥"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "只回复 OK"}]
}'
模型名以 模型价格 为准。
五、多模态怎么用
不同网关对多模态的支持方式不同，常见有两种：
- URL 传入：messages 里传图片/视频 URL。
- Base64 传入：把文件编码后放进请求。
使用前先确认网关支持的字段和大小限制，不要直接照搬官方 SDK 的格式。先用一张小图测试，再上生产。
六、测试清单
- 文本请求。
- 流式输出。
- 图片输入。
- 长上下文。
- 5/10 并发。
- 429/5xx 处理。
- 账单核对。
七、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 连接超时 | 无法访问 Google | 使用国内可达网关 |
| 401 | Key/地址不匹配 | 检查 Key 与 Base URL |
| 404 | 路径错 | 只填到 /v1 |
| 429 | 配额/频率 | 降并发、重试、升级额度 |
| 多模态报错 | 字段/大小不支持 | 查网关文档，先小文件测试 |
八、官方直连 vs 中转
| 维度 | 官方直连 | 中转网关 |
|---|---|---|
| 访问 | 受网络影响 | 国内可达 |
| 支付 | 官方方式 | 站内充值 |
| 模型 | 只有 Gemini | 可多模型 |
| 账单 | 官方后台 | 统一控制台 |
| 多模态 | 官方完整能力 | 取决于网关支持 |
如果只需要 Gemini、官方访问正常，直连也可以；如果国内访问不稳定或需要多模型，中转更合适。
下一步
需要国内访问或多模型统一入口，可以先 注册中商起航 AI 网关，用小额 Key 测试文本和多模态。模型和价格以 模型价格 为准。
相关阅读：
