- Poixe 的兼容性取舍:哪些功能在 Poixe 环境下受限/不可用,以及原因与替代建议。
- 已知的上游注意点:一些来自厂商原生接口的“坑位提示”(并非 Poixe 引入),用于帮助你少踩坑、快速定位问题。由于上游实现与文档会变化,这些提示可能不全,仅供参考。
设计原则:最小侵入,不做协议转换
Poixe 的核心设计原则是:最小侵入性(Minimal Invasiveness)。 这意味着:- 我们不会将一种协议的请求 转换成另一种协议 再调用上游。
例如:不会把
OpenAI Chat Completions的请求转换为OpenAI Responses协议再转发。 - Poixe 只做转发、鉴权、调度、计费与日志,上游调用使用的是厂商原生提供的协议与行为。
- 如果你使用
OpenAI Chat Completions协议调用 OpenAI 模型:请直接参考 OpenAI 官方文档。 - 如果你使用同样的协议调用 Azure OpenAI:请参考 Azure 提供的对应文档与参数约束。
- 如果你想通过
OpenAI Chat Completions协议调用 Claude 模型:请参考 Anthropic 提供的对应接口说明(包括其兼容接口的特性与限制)。
Poixe 系统是直接对接各个厂商提供的协议接口,而不是由 Poixe 在中间做语义转换,所以协议差异需要以各厂商文档为准。