Claude Code
CLIAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
环境变量或 ~/.claude/settings.json
Answer
先给结论
Gemini API 的服务器由 Google 运营，国内网络环境下无法直接访问。开发者需要通过 API 中转服务来实现调用。QuickRouter 通过国内节点提供 Gemini API 的中转服务，使用统一的 OpenAI 兼容接口，无需学习新的 SDK。
QuickRouter 的解决方式
使用 QuickRouter 接入 Gemini 非常简单：将 base_url 设置为 https://api.quickrouter.ai/v1，在 model 参数中指定 Gemini 模型，填入 QuickRouter API Key 即可。支持 OpenAI Python SDK、Node.js SDK、cURL，以及 Cursor、Codex、opencode、Trae 等常用开发工具。
Gemini API 国内访问面临哪些问题？
与 OpenAI 类似，Google Gemini 的 API 端点在国内无法直接访问。开发者如果需要使用 Gemini 的多模态、长上下文等能力，需要通过中转服务来接入。
为什么选择 QuickRouter 接入 Gemini？
QuickRouter 提供统一的 OpenAI 兼容接口，调用 Gemini 模型的方式和调用 GPT-5 完全一致。同一个 API Key 和 Base URL 可以同时使用 OpenAI、Claude、Gemini、DeepSeek 等多个模型。
Gemini 也可以用统一接口调用
Cursor、Codex、opencode 使用 https://api.quickrouter.ai/v1；Trae 一般模型 URL 使用 https://api.quickrouter.ai/v1/chat/completions，然后选择 Gemini 模型。
配置速查
先按工具确认 URL、API Key 和模型名，再进入完整教程。这样从搜索页进来的用户可以直接完成第一次调用。
Gemini 通过 OpenAI 兼容方式调用
如果你只是想在国内稳定调用 Gemini，不一定要单独研究 Google 的 SDK。QuickRouter 可以用统一的 OpenAI 兼容地址承接。
OpenAI SDK / Cursor / Codex / opencode
https://api.quickrouter.ai/v1
Base URL 统一填这个，model 参数选择 Gemini 模型。
Trae 一般模型 URL
https://api.quickrouter.ai/v1/chat/completions
Trae 调 Gemini 时使用一般模型 URL。
API Key
登录后台 → API令牌 → 复制
同一个 QuickRouter Key 可以调用 OpenAI、Claude、Gemini、DeepSeek 等模型。
模型示例
gemini-3.5-flash
适合先做连通性测试；正式模型以控制台和价格页为准。
适合优先用 Gemini 的情况
多模态
图片理解 / 图文输入
Gemini 在多模态和长上下文场景里经常是不错选择。
成本控制
Flash 系列
需要响应速度和成本平衡时，可以先从 Flash 模型测试。
备用模型
同一 Key 切换模型
当 GPT 或 Claude 不适合当前任务时，可以直接切换 Gemini 模型。
适合的开发场景
✓
多模态内容处理（文本 + 图片）
✓
长文本理解与摘要（论文、合同、报告）
✓
内容生成与营销文案
✓
企业知识库问答
下一步配置
选择你的工具，完成第一次调用
如果你是从搜索进入本页，可以直接按正在使用的工具复制 API Key、Base URL、模型示例，并跳转到对应配置教程。
opencode
TerminalAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
~/.config/opencode/opencode.json+auth.json
Cursor
IDEAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
Settings → Models
Codex
AgentAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
gpt-5.5
填写位置:
~/.codex/config.toml + ~/.codex/auth.json
Cherry Studio
DesktopAPI Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
设置 → 添加 → 添加提供商
Trae
BuilderAPI Key:
登录后台 → API令牌 → 复制
一般模型 URL:
https://api.quickrouter.ai/v1/chat/completions
Claude 模型 URL:
https://api.quickrouter.ai/anthropic/v1/messages
模型示例:
gpt-5.5 / claude-sonnet-4-6
填写位置:
Settings → Models → Custom Model
常见问题
Gemini API 国内有哪些接入方式？▾
国内开发者可以通过 QuickRouter 等 API 中转服务接入 Gemini API。QuickRouter 使用 OpenAI 兼容接口，替换 Base URL 即可调用。
QuickRouter 支持哪些 Gemini 模型？▾
支持 Gemini 2.5 Pro、Gemini 2.5 Flash 等主流模型。具体可用型号以 QuickRouter 控制台和价格页为准。
Gemini 的多模态能力可以通过中转使用吗？▾
可以。QuickRouter 支持 Gemini 的多模态输入功能，包括文本和图片的处理。具体使用方式请参考文档。
计费方式是怎样的？▾
采用按量付费模式，根据实际使用的模型和 Token 数量计费。充值可享折扣，具体价格请查看价格页。