pi-gemini-oauth-apikey

多账号轮询调用Google Gemini API,自动处理频率限制。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-gemini-oauth-apikey。
它的用途是:多账号轮询调用Google Gemini API,自动处理频率限制。
完整的 Skill 内容见:https://321skill.com/skills/pi-gemini-oauth-apikey/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“调用Gemini分析这段代码。”,Skill会在后台从你配置的账号池中选取一个可用账号发起请求;如果该账号因调用过快被限制(返回429错误),它会自动无缝切换到下一个账号重试,确保你的请求总能得到响应。

介绍

这个Skill主要解决了开发者在使用Google Gemini API时,单个账号容易触发请求频率限制(HTTP 429错误)导致服务中断的问题。它通过建立一个多账号池,在遇到频率限制时自动切换到下一个可用账号,从而保证服务的连续性和稳定性。

使用上,你需要预先注册多个Google Gemini账号(基于Cloud Code Assist OAuth),并将它们的认证信息配置到该Skill中。该Skill依赖于@qraxiss/pi-gemini-auth来处理底层的OAuth认证流程。配置完成后,Skill会自动管理这些账号的令牌刷新和轮换逻辑,你只需像调用单个API一样使用它即可。

它非常适合那些需要高频、稳定调用Gemini API进行应用开发、自动化脚本或AI集成的开发者或团队。尤其是当你的应用对API服务的可用性要求较高,不希望因单账号限制而中断业务逻辑时。

需要注意的是,使用此Skill的前提是你需要拥有多个有效的Google Gemini账号。请确保遵守Google Cloud的服务条款,合理使用API。此外,账号轮换逻辑主要针对频率限制(429错误),对于其他类型的API错误可能不会触发切换。

核心特点

核心区别在于专门针对Google Gemini API的频率限制设计了多账号自动轮换机制,而非简单的单账号调用;并且其实现依赖于特定的OAuth认证库(@qraxiss/pi-gemini-auth),专注于Cloud Code Assist的认证流程,与通用API Key轮换方案不同。

注意事项

不适合只有单个Google Gemini账号或调用频率极低的用户。

常见问题

需要多少个Google账号?

至少两个,越多越能平滑应对频率限制。

能用于其他AI API吗?

不能,它专门为Google Gemini API设计。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-gemini-oauth-apikey/raw/index.md 读取 pi-gemini-oauth-apikey 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。