QuickRouter API 大模型API聚合中转平台QuickRouter API

Gemini API Key 国内使用教程

Google Gemini 在国内无法直接访问 API。本文介绍如何通过 QuickRouter 获取 API Key 并在国内使用 Gemini 模型,支持 Gemini 2.5 Pro、Gemini 2.5 Flash 等模型,兼容 OpenAI SDK,按量付费。

配置前准备

1注册 QuickRouter 账号
2安装 OpenAI SDK(Python 或 Node.js)

配置方法

1
在 QuickRouter 注册账号并获取 API Key
2
在代码中将 base_url 设置为 https://api.quickrouter.ai
3
在 model 参数中指定 Gemini 模型,填入 API Key 开始调用
gemini_api_key_example.py
from openai import OpenAI

client = OpenAI(
    api_key="QUICKROUTER_API_KEY",
    base_url="https://api.quickrouter.ai"
)

response = client.chat.completions.create(
    model="gemini-2.5-pro",  # 或 gemini-2.5-flash
    messages=[{"role": "user", "content": "请分析一下人工智能的发展趋势"}]
)
print(response.choices[0].message.content)

常见工具配置

通过 QuickRouter 使用 Gemini API Key 的方式和使用 OpenAI 完全一致。同一个 API Key 还可以调用 Claude、GPT-5、DeepSeek 等其他模型,只需在 model 参数中切换即可。
下一步配置

选择你的工具,完成第一次调用

如果你是从搜索进入本页,可以直接按正在使用的工具复制 API Key、Base URL、模型示例,并跳转到对应配置教程。

Claude

Claude Code

CLI
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
环境变量或 ~/.claude/settings.json
查看 Claude Code 配置教程
opencode

opencode

Terminal
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
~/.config/opencode/opencode.json+auth.json
查看 opencode 配置教程
Cursor

Cursor

IDE
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
claude-sonnet-4-6
填写位置:
Settings → Models
查看 Cursor 配置教程
OpenAI

Codex

Agent
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai/v1
模型示例:
gpt-5.5
填写位置:
~/.codex/config.toml + ~/.codex/auth.json
查看 Codex 配置教程
Cherry Studio

Cherry Studio

Desktop
API Key:
登录后台 → API令牌 → 复制
Base URL:
https://api.quickrouter.ai
模型示例:
claude-sonnet-4-6
填写位置:
设置 → 添加 → 添加提供商
查看 Cherry Studio 配置教程
Trae

Trae

Builder
API 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
查看 Trae 配置教程

常见问题

QuickRouter 的 Gemini API Key 和 Google 官方的一样吗?

QuickRouter 使用自己的 API Key 体系。你不需要申请 Google 官方的 API Key,注册 QuickRouter 即可获取 Key 来调用 Gemini 模型。

支持哪些 Gemini 模型?

支持 Gemini 2.5 Pro、Gemini 2.5 Flash 等主流模型。具体可用型号以控制台和价格页为准。

Gemini 的多模态功能支持吗?

支持。通过 QuickRouter 调用 Gemini 时可以使用多模态输入功能,具体使用方式请参考文档。

如何切换不同的 Gemini 模型?

只需修改请求中的 model 参数,例如从 gemini-2.5-pro 切换到 gemini-2.5-flash,其他代码不变。