Gemini API 在中国如何调用？开发者指南

Gemini API Python request

先把账号、网络和接口分开

地区可用性、请求是否到达上游、SDK 字段是否正确，会产生不同错误。不要把所有失败都当成网络问题。

使用最小请求

Key 从环境变量读取，先用无敏感内容验证 endpoint、模型名和鉴权头。

兼容接口要单独测试

OpenAI 兼容不等于字段、流式事件和工具调用完全相同。

按顺序完成

1. 读取 Key. 把凭据放在环境变量中，不要写进仓库。
2. 发送短请求. 先验证 endpoint、模型名和请求体。
3. 分类错误. 400/401/403 先修配置，429 只做有限退避，5xx 再看上游。
4. 小流量观察. 确认延迟、额度、扣费和限流后再扩大调用。

FAQ

429 可以一直重试吗?
不可以，只做有上限的退避，超过上限就停止。

API Key 放哪里?
环境变量或密钥管理服务。

兼容接口完全一样吗?
不是，鉴权头、模型名和事件格式仍需验证。