返回AI 通道
Gemini 2.5 Pro · 国内一键接入

Gemini 2.5 Pro 国内一键接入指南 · Google AI 中转

Gemini 2.5 Pro 在 2M context、native multimodal、deep thinking 三件事上都是 SOTA,但国内开发者卡在 Google AI Studio 的访问限制、Vertex AI 的项目化部署门槛、Google Cloud 信用卡校验。AI 通道把 Google Generative AI 协议(/v1beta/models/...:generateContent)完整代理 —— 桌面端走 CC Switch / Cherry Studio 一键 deeplink 自动导入,代码端 Python SDK 改一个 endpoint。Gemini 2.5 Pro / Flash / Flash-lite 全系按 1 RMB ≈ 1 USD 计价。

一键接入 · 4 种客户端任选其一

登录后 dashboard 选你想用的客户端卡片,后端帮你拼好 deeplink(桌面工具)或命令(终端工具)。每种客户端都不需要手动配 endpoint 或 API key,也绕开 Google OAuth。

  • CC Switch(桌面切换器 · 主推 Gemini CLI)

    桌面 GUI,一键 deeplink 把官方 Gemini CLI 的 endpoint + API key 自动注入,绕开 Google OAuth。

    查看 CC Switch 接入指南 →

  • Cherry Studio(桌面 AI 客户端)

    桌面 Chat + Agent + 知识库,Dashboard 一键 deeplink 自动配 Gemini provider(走 new-api type 原生路由)。

    查看 Cherry Studio 接入指南 →

  • Chatbox(桌面 + 移动)

    跨平台桌面 + 移动 AI 客户端,一键 deeplink 配 Gemini 系列 provider(走 OpenAI 兼容 shim)。

    查看 Chatbox 接入指南 →

  • Hermes(终端 · 多模型 CLI)

    NousResearch 极简多模型 CLI,默认 model 预填 gemini-2.5-pro,适合 shell 脚本场景。

    查看 Hermes CLI 接入指南 →

极速通道 · CC Switch 把 Gemini CLI 配置自动注入

最快路径:登录后 dashboard 点 CC Switch 卡片,选 Gemini CLI 应用,生成 deeplink 一键打开 → CC Switch 自动写入 endpoint + API key + 模型默认值。不用碰 ~/.config/gemini-cli/config.toml、不用 OAuth 登录 Google 账号。

  1. 1

    注册 / 登录 AI 通道

    邮箱注册即可,微信/支付宝充值最低 ¥10。

  2. 2

    装 CC Switch + Dashboard 选 CC Switch 卡片

    从 CC Switch GitHub Releases 下载桌面端,启动一次。然后在 AI 通道 dashboard 点 CC Switch 卡片,选 Gemini CLI 应用 + Gemini 分组。

  3. 3

    点"在 CC Switch 中打开"

    ccswitch://v1/import?resource=provider&app=gemini
  &endpoint=https://ai.aitongdao.com
  &apiKey=sk-xxxxxx
  &model=gemini-2.5-pro
  &usageEnabled=true

    浏览器跳到 CC Switch,自动填好 provider 配置、apiKey、模型默认值,还顺手开启每 60 分钟刷一次余额查询。Cherry Studio / Chatbox 同样有 deeplink 卡片。

为什么用 AI 通道接 Gemini 2.5 Pro

  • 免翻墙、免 Google Cloud 项目

    Google AI Studio 在国内基本无法访问,Vertex AI 又要先开 Google Cloud 项目、绑信用卡、过 SCC 审批,流程能耗一周。AI 通道走标准 generativelanguage.googleapis.com 协议代理,注册只填邮箱、微信支付宝充值即可。

  • 原生 Gemini 2.5 Pro / Flash / Flash-lite 全系

    模型版本与 Google AI Studio 一致,2M context、native multimodal(图像 / 视频 / 音频 / PDF)、deep thinking、structured output、function calling 全部支持。AI 通道侧不裁剪 prompt、不丢 multimodal payload。当前 Gemini 分组覆盖:Gemini 2.5 Pro / 3 Pro / 3 Flash 全系,大上下文 + 多模态。

  • 按 1 RMB ≈ 1 USD 计价,即官方 约 1.2 折

    Gemini 分组倍率 0.8x · 折合官方约 1.2 折。Multimodal 输入按 token 等价计费,thinking token 单独计费,与 Google 官方计价方式一致。Dashboard 实时查每个 key 的 token 用量。

  • 桌面客户端一键 deeplink 导入

    CC Switch、Cherry Studio 都支持 Gemini 协议 deeplink —— 在 dashboard 选对应卡片 + Gemini 分组 + 应用,生成 ccswitch:// / cherry-studio:// URL,点一下桌面 app 就自动配置好 provider,不用复制粘贴 endpoint / key / model。

不用 deeplink?直接调 Gemini SDK / CLI(适合应用集成)
  1. A

    Python SDK(google-generativeai)

    pip install google-generativeai:

    import google.generativeai as genai

genai.configure(
    api_key="sk-xxxxxx",
    transport="rest",
    client_options={"api_endpoint": "ai.aitongdao.com"},
)

model = genai.GenerativeModel("gemini-2.5-pro")
resp = model.generate_content("Hello")
print(resp.text)
  2. B

    Node SDK(@google/generative-ai)

    import { GoogleGenerativeAI } from "@google/generative-ai";

const genAI = new GoogleGenerativeAI("sk-xxxxxx");
const model = genAI.getGenerativeModel(
  { model: "gemini-2.5-pro" },
  { baseUrl: "https://ai.aitongdao.com" }
);
const resp = await model.generateContent("Hello");
console.log(resp.response.text());
  3. C

    Gemini CLI(手动 env var,绕开 OAuth)

    装官方 CLI:npm install -g @google/gemini-cli。然后:

    export GEMINI_API_KEY="sk-xxxxxx"
export GEMINI_API_ENDPOINT="https://ai.aitongdao.com"
gemini

    Gemini CLI 默认走 OAuth(国内访问 oauth2.googleapis.com 不通),用 GEMINI_API_KEY + GEMINI_API_ENDPOINT 走 API key 路径。CC Switch deeplink 也是写到这两个 env。

常见问题 FAQ

跟 Google AI Studio 在功能上有什么差别?

没有功能差别。AI 通道只在 HTTP 层做转发与计费记账,不修改 prompt、不丢 multimodal 输入、不限制 generationConfig 参数。Gemini 2.5 Pro 的 deep thinking、Flash 的低延迟、Flash-lite 的极致便宜全部保留。

国内用 Gemini API 需要 VPN 吗?

不需要。AI 通道的 endpoint 是 ai.aitongdao.com,走国内经首尔节点的中转链路,国内直连,无需代理 / VPN / 翻墙。Google AI Studio 官方 API(generativelanguage.googleapis.com)在国内三大运营商访问时通常超时或 403,AI 通道把这层全部绕开,SDK 只需要换 base URL + API Key 即可。

2M context 真的能用满吗?

可以。AI 通道不裁剪 input,2M token(约 1.5M 中文字)的上下文请求完整透传。但要算清成本:大输入按 Gemini 单价计费,适合一次性塞整个 codebase 或长文档。Dashboard 实时看每次请求的 token 数量。

支持图片 / 视频 / PDF 输入吗?

支持。Gemini 的 native multimodal 全部直通,inline_data(base64)和 file_data(File API)两种上传方式都可用。Video 输入会按 1 fps 采样后按 token 计费,与官方计价方式一致。

是否支持 deep thinking 模式?

支持。Gemini 2.5 Pro 的 thinking 模式默认启用,可以通过 generationConfig.thinkingConfig.thinkingBudget 调节预算(0 关闭、-1 自动、正整数指定 token 数)。Dashboard 会单独统计 thinking token 用量。

是否支持 function calling / structured output?

支持。tools 字段、responseSchema(JSON Schema 强类型输出)、responseMimeType: "application/json" 全部直通。Tool calling 的并行执行也支持。

Gemini CLI 的 OAuth 模式可以用吗?

不行。Gemini CLI 默认有 OAuth 走 Google 账号的模式,但那条路在国内访问 oauth2.googleapis.com 不通。AI 通道走 API key 路径,CC Switch 一键 deeplink 自动给你写好;手动配置则在 CLI 启动前 export GEMINI_API_KEY + GEMINI_API_ENDPOINT 即可绕开 OAuth。

跟 Vertex AI 的兼容性如何?

AI 通道走的是 Google AI Studio 协议(generativelanguage.googleapis.com),不是 Vertex AI 协议(aiplatform.googleapis.com)。两者请求格式不同,Vertex SDK 不直接兼容。如果你的代码原本用 Vertex SDK,需要切到 google-generativeai SDK 或直接用 REST。

Gemini 系列价格 · 实时数据

AI 通道按 1 RMB ≈ 1 USD 计价 —— 倍率就是官方折扣,不要再 × 汇率(那样会算贵)。当前实时汇率 1 USD ≈ 6.84 RMB:

  • Gemini 分组 · 倍率 0.8x · 折合官方约 1.2 折
    ✨ Gemini 2.5 Pro / 3 Pro / 3 Flash 全系,大上下文 + 多模态

完整模型清单和单价见 价格页。

开始用 Gemini 2.5 Pro(国内一键接入)

注册 → 充 ¥10 → 装 CC Switch → Dashboard 选 Gemini CLI 卡片 → 点 deeplink 自动导入。