免费调用Gemini 3 Pro API教程：Claude Code/Cherry Studio实战接入指南

Google 的 Gemini 3 Pro 模型能力出众，但不少开发者还不清楚：借助一个开源工具，你可以完全免费地通过 API 调用 Gemini 3 Pro，不仅支持编码辅助，还能调用 Imagen 生成图片。更实用的是，一个 API 端点同时兼容 OpenAI、Gemini 和 Anthropic 三种协议，能够无缝接入 Claude Code、Gemini CLI、Cherry Studio 等主流 AI 工具。

这篇教程将手把手带你完成工具配置，并通过三个实战场景验证效果。

核心工具：Anti-Graffiti Tools 介绍与配置

工作原理

用过 Google AI Studio 的朋友应该知道，Google 在页面上为 Gemini 3 Pro 和 Imagen（图片生成）等模型提供了免费使用额度。Google AI Studio 是 Google 为开发者提供的 AI 模型试验平台，用户可以在网页界面中直接与 Gemini 系列模型交互。Google 为每个账号提供了每日免费调用额度（Rate Limit），通常包括每分钟请求数和每日总 Token 数的限制。这一策略旨在让开发者零门槛体验最新模型能力，同时通过限额控制服务器成本。

Anti-Graffiti Tools 这个开源项目的核心思路是：通过页面登录 Google 账号后，将 API 请求转化为页面请求。换句话说，当你通过 API 调用模型时，实际消耗的是 AI Studio 页面中的免费额度，从而实现零成本调用 Gemini 3 Pro。

安装与配置步骤

第一步：下载安装

前往该项目的 GitHub Release 页面，下载最新版本（例如 3.33.2 Windows 版），双击安装文件，按提示一路点击下一步即可完成安装。

第二步：添加 Google 账号

打开软件后，首先添加 Google 账号。默认使用 OAuth 授权（第一项），操作最简单。OAuth（Open Authorization）是一种开放标准的授权协议，允许第三方应用在不获取用户密码的情况下访问用户资源。在这个场景中，OAuth 授权流程会引导用户跳转到 Google 登录页面完成身份验证，然后 Google 返回一个访问令牌（Access Token）给工具。工具使用这个令牌代表用户向 AI Studio 发起请求，比直接存储用户名密码更安全，因为令牌可以设置有效期和权限范围，用户也可以随时在 Google 账号设置中撤销授权。

想要获得更多免费额度的话，可以添加多个 Google 账号轮换使用，或者登录一个 Google 付费 Pro 账号来获取无限调用量。

第三步：获取 API 连接信息

登录成功后进入 API 面板，可以看到服务端口、API 密钥以及支持的模型列表。面板右侧展示了 Base URL 和 API Key——这两个信息是后续接入各种 AI 工具的关键。

第四步：配置模型映射（可选）

由于不同 AI 工具对模型名称的定义可能存在差异，你可以使用模型映射功能，将其他软件中的模型名称映射到 Gemini 的对应版本，确保调用不出错。例如，Claude Code 默认请求的模型名称是 claude-sonnet-4-20250514，通过映射功能可以将其自动转换为 gemini-2.5-pro，中间层完成格式转换后，调用方完全无感知。

第五步：启动服务

所有配置完成后，点击右上角的「启动服务」按钮，API 服务就正式运行了。

多协议兼容的技术背景

理解 Anti-Graffiti Tools 的多协议兼容能力，需要了解当前主流 AI API 的差异。OpenAI 的 Chat Completions API 使用 messages 数组和 role/content 结构；Anthropic 的 Messages API 在请求头中要求 x-api-key 和特定版本号；Google 的 Gemini API 则使用 generateContent 端点和 parts 结构。多协议兼容意味着中间层需要解析来自不同格式的请求，统一转换为目标模型能理解的格式，再将响应转换回调用方期望的结构。这种适配层设计在 API 网关和代理服务中非常常见，使得一个后端服务能够同时服务于生态中的各类工具。

实战一：在 Claude Code 中调用 Gemini 3 Pro

这是一个相当巧妙的玩法——不是用 Gemini 的 CLI，而是直接在 Claude Code 中调用 Gemini 3 Pro 模型。之所以能实现，是因为 Anti-Graffiti Tools 完整兼容了 Anthropic 的 API 协议规范。

Claude Code 是 Anthropic 推出的命令行编码助手工具，允许开发者在终端中通过自然语言与 AI 协作完成代码编写、调试和重构任务。它支持 SPEC（Specification-Driven Development）工作流，即先生成技术规范文档再逐步实现代码。Claude Code 默认调用 Anthropic 自家的 Claude 模型，但由于其通过标准 API 端点通信，只要提供兼容 Anthropic 协议的 Base URL 和 API Key，就可以将底层模型替换为其他兼容服务。

配置方法

和使用其他 API 代理站的方式一样，你可以通过 cs switch 或 Web 等第三方工具进行切换，只需填入 Base URL 和 API Key。也可以手动在 settings.json 文件中设置对应的环境变量。

实测效果

设置完成后启动 Claude Code，将模型切换为 Claude Sonnet 4.5（底层实际调用的是 Gemini 3 Pro）。输入指令：「编写一个粒子的 3D 动画，支持手势缩放和旋转等操作」，可以看到已经进入了 SPEC（规范开发）工作流，模型正常响应并开始生成代码。

回到 Anti-Graffiti Tools 的仪表盘刷新额度，可以看到数值发生了变化，证明 Claude Code 成功调用了 Gemini 3 Pro 模型。

实战二：在 Gemini CLI 中原生调用 Gemini 模型

用 Gemini CLI 调用 Gemini 3 Pro，可以说是最「原汁原味」的使用方式，体验和官方几乎没有区别。

Gemini CLI 是 Google 推出的命令行 AI 开发工具，定位类似于 Claude Code 和 GitHub Copilot CLI。它允许开发者在终端环境中直接与 Gemini 模型交互，执行代码生成、项目初始化、文件编辑等操作。CLI 工具的优势在于可以直接访问文件系统和项目上下文，使 AI 能够理解整个代码库结构并进行全局性的修改。通过环境变量配置 API 端点，开发者可以灵活切换模型后端而无需修改工作流程。

配置方法

分别设置 API Key 和 Base URL 的环境变量即可。特别提醒：如果你没有开启全局代理，建议手动设置代理环境变量以确保网络连接通畅。

实测效果

输入 gemini 启动后，使用体验和平时完全一致。比如输入 /init 初始化当前项目，很快就能看到生成了 Gemini 的 MD 文档。

Gemini 3 Pro 的一大亮点在于前端 UI 开发能力。你可以提供 UI 原型图，让它基于原型进行 Flutter APP 的项目开发，整个过程非常流畅。Gemini 会规划完整的开发计划，你可以持续让它推进，直到整个项目完成。这种多模态理解能力（同时处理图像和文本输入）使得从设计稿到代码的转换变得前所未有的高效。

再次回到仪表盘页面，可以看到相应模型的使用量变化，确认 Gemini CLI 的 API 调用成功。

实战三：在 Cherry Studio 中解锁对话与图片生成

Cherry Studio 是一款广受欢迎的 AI 对话客户端，配合 Anti-Graffiti Tools 可以同时解锁 Gemini 3 Pro 的对话能力和 Imagen 的图片生成能力。

Imagen 是 Google DeepMind 开发的文本到图像生成模型系列，基于扩散模型（Diffusion Model）架构。与 Stable Diffusion 和 DALL-E 类似，Imagen 通过逐步去噪过程将随机噪声转化为高质量图像。其核心优势在于对自然语言提示词的深度理解能力，这得益于 Google 在大语言模型方面的积累。Imagen 3 是该系列的最新版本，在图像质量、文字渲染和细节表现方面有显著提升，尤其擅长生成照片级真实感图像和艺术风格作品。

配置方法

1. 打开 Cherry Studio，进入系统模型设置，找到 Gemini 配置项
2. 分别添加 Gemini 3 Pro（对话模型）和 Gemini 3 Image（即 Imagen 图片生成模型）
3. 模型 ID 直接从 Anti-Graffiti Tools 的模型列表中复制粘贴即可

对话能力测试

在对话框中新建窗口，选择 Gemini 3 Pro 模型，输入「创建一个 3D 粒子效果的球，使用单页面」。响应速度非常快，一个 3D 粒子球效果很快就生成出来了，支持放大查看细节。

虽然没有设置系统提示词时效果可能不如 AI Studio 中的表现，但完全可以继续迭代优化。比如让它「修改粒子为圆形，整体为球形」，效果立刻改善。建议在对话中添加自定义系统提示词，充分发挥 Gemini 3 Pro 的能力。系统提示词（System Prompt）是预设在对话开头的指令文本，用于定义 AI 的行为模式、输出格式和专业领域，相当于给模型设定一个「角色」，能显著提升特定任务的输出质量。

图片生成测试

重新打开一个对话窗口，切换到 Imagen 模型，直接输入图片描述提示词。实测不仅能生成漫画风格的风景画面，还可以让它逐一生成系列图片，整体效果令人满意。

免费使用 Gemini 3 Pro API 的注意事项

通过 Anti-Graffiti Tools 这个开源工具，你可以零成本调用 Gemini 3 Pro 及相关高级模型，并灵活接入 Claude Code、Gemini CLI、Cherry Studio 等多种 AI 工具。核心优势总结如下：

• 完全免费：消耗的是 Google AI Studio 的免费页面额度，无需绑定信用卡
• 多协议兼容：同时支持 OpenAI、Gemini、Anthropic 三种 API 协议
• 多场景覆盖：编码辅助、AI 对话、图片生成一站式解决
• 扩展性强：支持多账号轮换和模型映射，灵活应对不同需求

需要注意的是，Google AI Studio 的免费额度存在每日上限。根据 Google 官方文档，免费层级的 Gemini 2.5 Pro 通常限制为每分钟 5 次请求、每日 25 次请求（具体数值可能随政策调整），对于轻度使用和开发测试来说基本够用，但密集开发时可能会触及限制。如果你的使用量较大，可以考虑添加多个 Google 账号轮换使用，或者升级为 Google 付费 Pro 账号以获取无限调用额度。此外，网络环境也很关键，由于 Google 服务在部分地区需要通过代理访问，建议确保代理设置正确以保证 API 连接稳定。

最后需要提醒的是，这类通过页面额度转 API 调用的方式存在一定的合规风险。Google 的服务条款可能会对自动化访问行为有所限制，建议用户在使用前仔细阅读相关条款，并将其主要用于个人学习和开发测试目的。

核心要点

• Anti-Graffiti Tools 通过将 API 请求转化为页面请求，实现免费调用 Gemini 3 Pro 模型
• 一个 API 同时兼容 OpenAI、Gemini 和 Anthropic 三种协议，可接入多种主流 AI 工具
• 支持三大使用场景：Claude Code 编码开发、Gemini CLI 项目开发、Cherry Studio 对话与图片生成
• 免费额度有每日上限，可通过多账号轮换或升级付费 Pro 账号扩展使用量
• 支持模型映射功能，解决不同工具间模型名称差异问题