> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Poixe 接口与各官方接口的兼容性与差异说明

Poixe AI 是一层 **API 转发与调度层**，聚合并提供多家主流模型厂商的 API 能力。由于 Poixe 需要在不同厂商之间实现稳定的转发、计费与风控，我们在兼容性上会做一些 **工程取舍**（例如计费困难、安全或稳定性策略）。因此，部分能力在 Poixe 环境下可能会被**限制、禁用或表现不同**。

本章节主要说明两类内容：

* **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 提供的对应接口说明（包括其兼容接口的特性与限制）。

<Callout type="info" icon="info-circle">
  Poixe 系统是直接对接各个厂商提供的协议接口，而不是由 Poixe 在中间做语义转换，所以协议差异需要以各厂商文档为准。
</Callout>

## 反馈与改进

如果你在使用过程中发现了新的兼容性差异、文档缺失、或有任何改进建议，欢迎随时反馈给我们。我们会尽量确认并补充到本章节中，帮助更多用户少踩坑。

<CardGroup cols={1}>
  <Card title="联系我们" href="/cn/help/introduction/overview">
    联系团队或反馈建议
  </Card>
</CardGroup>
