Gemini API 中转接入:OpenAI 兼容配置与实时模型
如果现有代码或工具已经支持 OpenAI-compatible provider,接入 TackleKey 时先替换 base URL、API Key 和模型名。不要先跑批量任务,先用一个短请求验证鉴权、模型、日志和余额。
当前公开 Gemini 模型候选
下表按模型名展示目录快照中的部分候选,共识别 34 个相关模型。具体价格和当前权限请以实时模型广场为准。
先用一个小请求验证
示例使用当前目录中的 google/gemini-2.5-flash。模型可用性可能变化,若价格页已不再显示该名称,请从实时目录复制新的完整模型名。
curl https://api.tacklekey.com/v1/chat/completions \
-H "Authorization: Bearer $TACKLEKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-2.5-flash",
"messages": [
{
"role": "user",
"content": "请用一句话返回 API 健康检查结果。"
}
],
"max_tokens": 64
}'
官方接口与 TackleKey 配置不要混用
Google 提供官方 OpenAI 库兼容方式;使用 TackleKey 时应改用 TackleKey base URL、API Key 和当前目录中的完整模型名。
查看 Gemini 官方 API 资料。官方资料用于理解原生接口;TackleKey 的实际入口、Key、模型权限和计费以 TackleKey 控制台、价格页和日志为准。
接入后按这个顺序检查
1. 鉴权
确认 Header 是 Authorization: Bearer ...,Key 属于当前账号且没有复制空格。
2. 模型名
从实时价格页复制完整模型名,不要凭记忆使用官方别名或已经过期的名称。
3. 日志与余额
请求后检查状态码、模型、消耗和余额记录,再决定是否增加并发或批量。
4. 失败处理
401 先查 Key 和 base URL,429 降低并发并退避重试,模型不存在则重新核对目录。