pi-gateway

为pi.dev提供兼容OpenAI API的本地网关

安装使用

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

帮我安装这个 AI Skill:pi-gateway。
它的用途是:为pi.dev提供兼容OpenAI API的本地网关
详细介绍见:https://321skill.com/skills/pi-gateway/
请根据该页面的说明完成安装。

使用示例

“启动pi-gateway服务并配置我的应用使用本地端点。”,它会提供一个本地API地址(如 http://localhost:8000/v1),你的应用只需将原本指向api.openai.com的请求改向该地址,即可无缝调用pi.dev的模型能力。

介绍

pi-gateway 是一个协议转换工具,它解决了开发者希望使用标准OpenAI API格式调用pi.dev模型的问题。通过本地运行一个兼容OpenAI的API网关,它将标准的OpenAI API请求格式转换为pi.dev的协议,使得原本依赖OpenAI API的客户端或工具能够无缝切换到pi.dev的模型上。

使用方式非常灵活,既可以作为独立的命令行工具运行,也可以作为pi-extension的包装器集成到现有工作流中。开发者只需通过npm安装,启动本地服务,然后就可以像调用OpenAI API一样,将请求发送到pi-gateway提供的本地端点。

这个工具非常适合那些已经熟悉OpenAI API生态,但希望尝试或迁移到pi.dev模型的开发者、研究人员以及应用构建者。它降低了切换成本,无需重写大量客户端代码。

在使用时,建议注意其作为“无状态协议转换器”的特性,它主要处理协议格式,不管理对话状态。对于需要复杂会话管理的应用,可能需要在客户端或应用层进行额外处理。同时,请确保pi.dev的服务可用性以获得最佳体验。

核心特点

核心区别在于它专门为pi.dev模型提供轻量级、无状态的OpenAI API兼容层,并提供了独立的CLI和扩展包装两种使用模式,而非一个通用的多模型代理框架。

注意事项

不适合需要复杂状态管理或多模型负载均衡的高阶代理场景。

常见问题

pi-gateway能用于生产环境吗?

作为轻量协议转换器可用于生产,但需自行评估稳定性和pi.dev服务可靠性。

支持哪些OpenAI API功能?

支持核心的聊天补全等兼容LiteLLM格式的请求,具体功能取决于pi.dev后端。