TackleKey
Gemini API 中转

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 tokensopenai
google/gemini-2.5-flash-lite-nothink$0.12 / 1M tokens$0.42 / 1M tokensopenai
google/gemini-2.5-flash-lite-preview-09-2025$0.12 / 1M tokens$0.42 / 1M tokensopenai
google/gemini-3.1-flash-lite-preview$0.27 / 1M tokens$1.58 / 1M tokensopenai
google/gemini-3.1-flash-lite$0.27 / 1M tokens$1.58 / 1M tokensopenai
google/gemini-3.1-flash-lite-preview-nothink$0.27 / 1M tokens$1.58 / 1M tokensopenai
google/gemini-2.5-flash$0.32 / 1M tokens$2.63 / 1M tokensopenai
google/gemini-2.5-flash-image$0.32 / 1M tokens$2.63 / 1M tokensopenai

先用一个小请求验证

示例使用当前目录中的 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 降低并发并退避重试,模型不存在则重新核对目录。

FAQ

Gemini API 中转的 base URL 怎么填?

OpenAI-compatible 请求先使用 https://api.tacklekey.com/v1,除非控制台或文档明确给出其他项目入口。

Gemini 模型名能直接用官方简称吗?

不要假设可以。请从 TackleKey 实时价格页复制完整模型名,因为路由前缀、版本和别名可能不同。

哪个 Gemini 模型最便宜或最好?

本页只展示公开价格候选,不作质量承诺。应结合实际请求成功、输出质量、速度、日志和实时价格做小流量比较。

用一次 OpenAI-compatible 配置先跑通

创建账号,生成项目 API Key,把客户端 base URL 换成 TackleKey 入口。Key 请放在服务端,扩大用量前先核对实时价格和日志。