Gemini API 中转接入:OpenAI 兼容配置与实时模型
如果现有代码或工具已经支持 OpenAI-compatible provider,接入 TackleKey 时先替换 base URL、项目 API Key 和模型名。不要先跑批量任务,先用一个短请求验证鉴权、模型、日志和余额。
当前公开 Gemini 模型候选
下表从生产公开 pricing 数据中按输入与输出参考价格之和排序,仅用于缩小测试范围,不代表质量、速度、稳定性或永久可用性排名。页面生成时共识别 24 个带正价格的相关模型。
| 完整模型名 | 输入参考 | 输出参考 | Endpoint |
|---|---|---|---|
google/gemini-2.5-flash-lite | $0.12 / 1M tokens | $0.42 / 1M tokens | openai |
google/gemini-2.5-flash-lite-nothink | $0.12 / 1M tokens | $0.42 / 1M tokens | openai |
google/gemini-2.5-flash-lite-preview-09-2025 | $0.12 / 1M tokens | $0.42 / 1M tokens | openai |
google/gemini-3.1-flash-lite-preview | $0.27 / 1M tokens | $1.58 / 1M tokens | openai |
google/gemini-3.1-flash-lite | $0.27 / 1M tokens | $1.58 / 1M tokens | openai |
google/gemini-3.1-flash-lite-preview-nothink | $0.27 / 1M tokens | $1.58 / 1M tokens | openai |
google/gemini-2.5-flash | $0.32 / 1M tokens | $2.63 / 1M tokens | openai |
google/gemini-2.5-flash-image | $0.32 / 1M tokens | $2.63 / 1M tokens | openai |
先用一个小请求验证
示例使用当前目录中的 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、项目 Key 和当前目录中的完整模型名。
查看 Gemini 官方 API 资料。官方资料用于理解原生接口;TackleKey 的实际入口、Key、模型权限和计费以 TackleKey 控制台、价格页和日志为准。
接入后按这个顺序检查
1. 鉴权
确认 Header 是 Authorization: Bearer ...,Key 属于当前项目且没有复制空格。
2. 模型名
从实时价格页复制完整模型名,不要凭记忆使用官方别名或已经过期的名称。
3. 日志与余额
请求后检查状态码、模型、消耗和余额记录,再决定是否增加并发或批量。
4. 失败处理
401 先查 Key 和 base URL,429 降低并发并退避重试,模型不存在则重新核对目录。