API 兼容与选择
用 OpenAI 兼容接口接入 XiuRouter，也保留客户端需要的原生协议
XiuRouter 同时提供 Responses、Chat Completions、Anthropic Messages 和 Gemini GenerateContent。先按客户端实际发送的协议选入口，再到文档完成配置和验证。
什么情况适合兼容 API
当应用允许控制请求地址和凭据时，兼容接口可以减少已有集成的迁移成本。
- 已有 OpenAI SDK 或兼容客户端，并且可以覆盖 Base URL 与 API Key。
- 应用需要从同一当前目录中选择模型与服务档位。
- 团队能在生产使用前核对目标协议、一次真实请求和对应使用记录。
当前协议入口
一个产品不等于一种请求格式。最终入口必须匹配客户端或 SDK 实际发送的协议。
responses
OpenAI Responses
- Base URL
- https://router-api.xiu.ai/v1
- 请求路径
- /responses
适合 Codex、使用 OpenAI Responses 形状的 Agent，以及希望从 Responses 开始的新应用。
当前接口是无状态兼容面；不要把 OpenAI 托管的存储会话、后台模式、联网检索或文件检索当作默认可用能力。
messages
Anthropic Messages
- Base URL
- https://router-api.xiu.ai
- 请求路径
- /v1/messages
适合 Claude Code、Anthropic SDK 和会按 Messages 语义发送请求的 Claude 原生客户端。
Messages 兼容不等于 Anthropic 全部平台能力；托管服务端工具、Message Batches 和 Files 不在当前兼容范围。
chat
OpenAI Chat Completions
- Base URL
- https://router-api.xiu.ai/v1
- 请求路径
- /chat/completions
适合只支持 Chat Completions 的客户端、已有 OpenAI-compatible 工具和部分自定义模型入口。
工具调用、流式输出和客户端专有 Agent 能力仍取决于客户端与所选模型，不能由兼容路径本身保证。
gemini
Gemini GenerateContent
- Base URL
- https://router-api.xiu.ai
- 请求路径
- /v1beta/models/YOUR_MODEL_ID:generateContent
适合 Gemini SDK 和需要 Gemini 原生 GenerateContent 请求形状的客户端。
模型 ID 位于请求路径中，Base URL 和 OpenAI SDK 的写法不同；应按当前文档配置，不要机械套用 /v1。
用三步选对路径
不要把一份通用 OpenAI 配置机械套到所有客户端；先看客户端实际会发出什么请求。
- 1
确认客户端协议
判断客户端发送 Responses、Chat Completions、Anthropic Messages 还是 Gemini GenerateContent。
- 2
确认模型与服务档位
从当前模型与价格页读取精确模型 ID、声明的端点类型、档位和单价。
- 3
验证一条真实请求
创建范围明确的 Key，发送一条小请求，再在使用记录中核对模型、档位、Token、状态和结算。