XiuRouter 同时提供 OpenAI Chat Completions、Responses API、Anthropic Messages 和 Gemini GenerateContent 入口。先确认客户端或 SDK 实际发送的协议，再配置对应 Base URL、API Key 和模型 ID。
路由存在不等于每个模型、每个服务分组都完整支持该协议；反过来，公共目录没有某个 supported_endpoint_types 声明，也不能直接判定该协议不可用。当前 Responses 和 Gemini 的模型级声明不完整，最终要用目标模型和服务分组发送一条小请求验证。
Base URL
| 客户端类型 | 配置值 |
|---|---|
| OpenAI 兼容 SDK 或应用 | https://router-api.xiu.ai/v1 |
会自己追加 /v1/messages 的 Claude 客户端 |
https://router-api.xiu.ai |
会自己追加 /v1beta/models/... 的 Gemini 客户端 |
https://router-api.xiu.ai |
| XiuRouter 控制台 | https://router.xiu.ai |
这里列的是客户端或 SDK 配置项中的 Base URL。直接使用 cURL 时要写完整请求地址，例如 Responses 使用 https://router-api.xiu.ai/v1/responses，Messages 使用 https://router-api.xiu.ai/v1/messages。
router-api.xiu.ai 让模型请求直连服务节点，不经过控制台的边缘转发。对中国大陆网络通常链路更短，也更适合长流式响应。实际速度会受地区、运营商和当前网络影响。
router.xiu.ai/v1 保留兼容转发，但不适合作为新的长流式配置。已有 OpenAI 兼容客户端通常只需替换 Base URL 和 API Key；模型 ID 相同时，其他请求配置可以先保持不变。
文本接口
| 方法与路径 | 用途 | 当前边界 |
|---|---|---|
GET /v1/models |
读取当前 Key 可访问的模型 | 需要 API Key；返回范围受账号和 Key 限制 |
POST /v1/chat/completions |
OpenAI Chat Completions | 已有 OpenAI-compatible 客户端和只支持该接口的工具 |
POST /v1/responses |
OpenAI Responses | 新建 OpenAI 风格应用、Agent、Codex 和推理工具链 |
POST /v1/responses/compact |
Responses 压缩 | 只对支持该能力的上游类型生效 |
POST /v1/messages |
Anthropic Messages | 接受 Claude 请求格式 |
GET /v1beta/models |
Gemini 模型列表 | 使用 Gemini 请求格式返回当前 Key 可见模型 |
POST /v1beta/models/{model}:generateContent |
Gemini GenerateContent | 接受 Gemini 原生请求格式 |
网关还存在图片、Embeddings、音频、Rerank 和 Moderation 路由，但具体模型与上游能力变化更快。没有在控制台和目标模型上验证前，不要只根据路径存在就写入生产依赖。
认证
OpenAI 兼容请求使用：
Authorization: Bearer YOUR_XIUROUTER_API_KEYAnthropic Messages 请求可以使用：
x-api-key: YOUR_XIUROUTER_API_KEY
anthropic-version: 2023-06-01XiuRouter 也接受 Messages 请求中的 Bearer Token，便于 Claude Code 等网关配置。API Key 不是 XiuAI 登录令牌，也不要使用控制台登录令牌调用模型。
Gemini GenerateContent 请求可以使用：
x-goog-api-key: YOUR_XIUROUTER_API_KEY也可以把 Key 放在 key 查询参数中。服务端会把这两种认证方式转换为 XiuRouter Bearer Token；不要同时在日志中保留完整查询地址。
Key 会限制什么
一把 XiuRouter API Key 可以限制：
- 服务分组或自动分组顺序。
- 可调用模型。
- 可用额度。
- 到期时间。
- 已有的允许访问 IP 配置。
控制台当前不提供 IP 限制编辑入口，但编辑 Key 时会保留已有配置。客户端提示 401、403 或“模型不可用”时，先核对这些限制。不要为了排障直接换成一把无限范围的共享 Key。
当前兼容边界
/v1/messages/count_tokens当前没有专用路由。Claude Code 官方把该端点列为可选项，缺失时会通过/v1/messages回退计算，因此它本身不是兼容阻断项，但可能增加推理请求和费用。- Claude Code 还依赖流式响应，并会随版本发送新的
anthropic-beta和请求字段。没有真实小任务结果前，不把 Messages 路由存在写成完整 Claude Code 兼容。 - 当前公开的是 Gemini GenerateContent 路由，不是 Gemini Interactions API；客户端如果只支持 Interactions，不能只替换 Base URL。
- Files、Fine-tuning、图片 Variations 和部分旧接口在当前网关中明确未实现。
- 某个模型能通过 Chat Completions，不代表它也能通过 Responses 或 Messages。
- 公共目录的
supported_endpoint_types可以作为提示，但当前不能单独作为 Responses 或 Gemini 的可用性结论。 - 客户端自己的云端功能、账号订阅和托管工具不会因为修改 Base URL 自动迁移到 XiuRouter。
- 本轮只验证了代码路由、公开状态和未认证请求返回
401，没有使用真实 Key 完成付费协议测试。
选择协议
优先沿用客户端或 SDK 的原生协议，不要先选协议再强行改客户端：
| 协议 | 推荐定位 |
|---|---|
| Responses | 新建 OpenAI 风格应用、Agent、Codex 和推理工具链 |
| Anthropic Messages | Claude Code、Anthropic SDK 和 Claude 原生能力 |
| Chat Completions | 已有 OpenAI-compatible 客户端和只支持该接口的工具 |
| Gemini GenerateContent | Gemini SDK 和 Gemini 原生客户端 |
不确定客户端发送什么时，先看客户端官方文档或请求日志，不要根据“OpenAI 兼容”四个字推断。XiuRouter 当前没有单独的 OpenResponses 入口；页面和文档只写实际开放的 OpenAI Responses 路由。
原生透传与协议转换
客户端发送的格式是入站协议。请求到达具体服务来源后，可能由上游原生处理，也可能由网关转换为该上游接受的格式。两条链路都可能完成基础文本请求，但工具调用、结构化输出、缓存、流式事件和 Token 统计不一定完全相同。
因此，页面和文档只把协议路由写成已提供能力，不把它写成所有模型的原生能力。准备使用专有字段时，要用目标模型、服务分组和真实客户端完成一次小任务，再扩大到生产流量。
来源与核对日期
本文按 XiuRouter 当前公开状态、xiu-router 路由与鉴权代码，以及 OpenAI、Anthropic 官方接口说明核对，日期为 2026-08-19。客户端和模型更新后，应重新验证实际请求路径与响应。