Gemini API 接入：模型 ID、Base URL 与协议核对

Gemini API 接入的最短路径

AIFast Link 已将 Gemini 加入 GPT 与 Claude 之外的模型目录。先在 Link 创建独立限额 Key，确认 Gemini 分组权限，再从当前账号模型列表复制 ID，通过 OpenAI 兼容接口发送一条短文本。不要使用 Google AI Studio 的 Key 请求 Link，也不要把 Link Key 发给其他服务商。

本页在 2026-11-02 核对了公开目录和 Google 官方协议文档，没有执行带 Key 的付费模型请求。以下命令是接入示例，不是成功调用记录；图像、音频、工具调用和长上下文需要按所选模型单独验收。

下载模板，先检查再调用

Link 独立 GitHub 仓库提供 Gemini 请求 JSON 和离线模型 ID 检查器。用 Node.js 22 或以上运行检查器，只读取本地模型列表，不读取 Key、不联网；精确命中、模型缺失和输入错误分别返回退出码 0、2、1。样例列表是演示数据，不是当前账号的调用记录。

Gemini 模板与离线检查步骤

实际排查时，用同一个 Key、域名和分组取得 /v1/models，只保留 data[].id 到仓库外的私有 JSON 文件，再交给检查器。命中只证明这份快照有该 ID，不证明当前权限、接口兼容或服务可用；不要把密钥和原始请求日志提交到 GitHub。

Google 官方接口与 Link 接口怎么选

OpenAI 兼容表示可以沿用相应 SDK 的请求格式，不表示账号、Key、账单或全部功能可以通用。先选服务商，再使用该服务商的地址、凭据和模型 ID；只替换模型名不会把 Google 账号变成 Link 账号。

上表两种方式都使用 Chat Completions 请求结构，但权限、计费和支持的参数分别由所选服务商决定。Google 官方地址不是 Link 的备用线路；不要把 Link Key 发到 Google，也不要反向混用。

Link 当前列出的 Gemini 模型

以下是 2026-11-02 公开目录快照，共 13 个 ID。它们是 Link 的目录名称，不是对 Google 官方发布、底层身份或长期可用性的认证。所有条目的声明分组均为 Gemini，声明接口均为 openai 和 gemini；价格与个人权限请回到实时目录核对。

查看 Link 实时模型与价格

OpenAI 兼容客户端配置

先在自己的终端安全设置 AIFAST_API_KEY，再查询账号可见模型。公开价格目录与带 Key 返回的模型列表用途不同；目录中出现某个模型，不代表每个账号或令牌都有权限。

curl --fail-with-body --silent --show-error \
  --connect-timeout 10 --max-time 30 \
  https://www.aifast.link/v1/models \
  -H "Authorization: Bearer ${AIFAST_API_KEY:?Set AIFAST_API_KEY locally before running}"

下面使用 gemini-2.5-flash 作为目录示例；执行前确认你的模型列表中有这个 ID，必要时替换。该请求会产生真实 API 用量，请使用临时限额 Key，不要在共享终端或公开日志里输出密钥。

curl --fail-with-body --silent --show-error \
  --connect-timeout 10 --max-time 60 \
  https://www.aifast.link/v1/chat/completions \
  -H "Authorization: Bearer ${AIFAST_API_KEY:?Set AIFAST_API_KEY locally before running}" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-2.5-flash","messages":[{"role":"user","content":"Reply with OK."}],"stream":false}'

记录 HTTP 状态、响应内容、model、usage 和 Link 用量日志。60 秒只是这个示例的客户端总时限，不是服务响应承诺。超时后先查最终账单，不要立即重复提交；一次文本成功不代表流式或工具调用通过。

Gemini 原生协议与兼容协议有什么不同

Link 目录声明的原生路径是 POST https://www.aifast.link/v1beta/models/{model}:generateContent。Google 官方原生协议使用 contents 和 parts；OpenAI 兼容请求使用 messages。两套响应结构和流式事件不同，不能只替换 URL 而保留另一种协议的请求体。

Link 原生鉴权、streamGenerateContent、文件上传与 Google 专有工具尚未完成验证。使用原生客户端前，向 Link 确认客户端版本、认证方式、最终路径和所需参数；Google 官方接口文档只作协议参考。

查看接口能力矩阵

Gemini 计费与月卡如何核对

Gemini 的模型目录、分组和账单按 Link 独立核对。先在模型广场检查输入、输出、缓存与分组价格，再对少量真实任务检查最终消耗。本页不写固定折扣、汇率或 Gemini 月卡价格，也不把现有 GPT/Claude 月卡扩展为 Gemini 权益。

2026-11-02 的公开 Gemini 条目采用 tiered_expr 阶梯表达式计费，不能只拿单个倍率推算最终售价。成本计算器适合单一输入、输出费率的文本估算；缓存、长上下文阶梯、思考输出或工具费用，应按实际账单类别另行核对。

按量充值与月卡范围

估算任务成本

常见接入问题

先保留脱敏状态码与响应，再按错误分类处理。模型名拼错或路径错误不能靠充值修复；超时和断流也不能证明服务端没有处理或计费，不要无限重试。

Chatbox、Cherry Studio 或 Dify 支持自定义兼容供应商时，可先按 OpenAI 兼容方式配置，再验证目标模型功能。Gemini 目录上架不代表它能直接替换 Claude Code 的 Messages 或 Codex 的 Responses；工具和协议需要独立验证。

Chatbox 与 Cherry Studio 配置

Dify 模型接入

Base URL 检查器