pi-openrouter-fallback
为Pi扩展OpenRouter模型支持，并在403错误时自动降级重试
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-openrouter-fallback。 它的用途是：为Pi扩展OpenRouter模型支持，并在403错误时自动降级重试 完整的 Skill 内容见：https://321skill.com/skills/pi-openrouter-fallback/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“用OpenRouter的`meta-llama/llama-3-70b-instruct`模型帮我总结这篇文章。” 当你的配额用尽返回403错误时，Skill会自动在后台将请求切换至`openrouter/free`模型并重新处理，最终你仍能收到一个文章总结，避免了对话中断和手动重试的麻烦。
介绍
这个Skill解决了在使用Pi（一个AI助手工具）时，调用OpenRouter收费模型因配额不足或权限问题返回HTTP 403错误，导致对话中断或需要手动处理的痛点。它通过在Pi中扩展对OpenRouter模型的支持，并智能监控API响应，当遇到403错误时，自动无缝切换到免费的“openrouter/free”模型并重新提交用户的请求，从而保障对话的连续性和可用性。
使用方式非常简单。在安装并配置好此Skill后，你只需像往常一样通过Pi向OpenRouter的收费模型发起请求。当Skill检测到403错误时，整个过程会在后台自动完成：它捕获错误，将请求模型切换为免费的备用模型，然后重新提交你的原始查询，最后将结果返回给你。你几乎感知不到中间发生的切换过程。
这个Skill非常适合那些深度依赖OpenRouter API进行开发、测试或日常工作的开发者、研究者以及AI应用爱好者。特别是对于预算有限、需要保证服务高可用性，或者在使用过程中偶尔会触发API限制的用户来说，它是一个提升体验的实用工具。
在使用建议上，请注意，自动切换到免费模型“openrouter/free”可能会在模型能力、响应速度或输出质量上与原来的收费模型存在差异。因此，它更适合作为保障基本功能可用的降级方案，而非性能对等的替代。建议在关键或对输出质量要求极高的生产任务中，仍需确保主用模型的配额充足。
核心特点
与仅提供OpenRouter模型调用封装的Skill不同，本Skill的核心在于其“故障自动转移”机制，能主动捕获HTTP 403错误并自动切换到免费模型重试，无需用户干预，显著提升了在配额波动时的服务韧性。
注意事项
不适合对模型输出质量和能力有严格一致性要求、无法接受降级到免费模型差异的生产环境核心任务。
常见问题
安装后如何配置OpenRouter API密钥？
通常需要在Pi或Skill的配置文件中设置你的OpenRouter API密钥，具体请参考Skill的详细文档。
自动切换后，我如何知道当前使用的是收费模型还是免费模型？
Skill的日志或返回的响应头中可能会包含模型信息，建议查看其运行日志或输出详情进行确认。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-openrouter-fallback/raw/index.md 读取 pi-openrouter-fallback 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-openrouter-fallback/raw/index.md（查看排版版本）