XiuRouter 是独立的模型 API 服务。你可以登录控制台、充值、创建受限的 API Key，再通过 Chat Completions、Responses、Anthropic Messages 或 Gemini GenerateContent 调用当前目录中的模型。新接入应把控制台和 API 地址分开配置。
发起第一次请求
创建 API Key，读取模型列表，再调用 Chat Completions。开始调用
确认 API 兼容范围
查看 OpenAI Chat Completions、Responses、Anthropic Messages、Gemini GenerateContent 路由和当前限制。查看兼容范围
接入开发工具
按客户端使用的协议选择 Codex、Claude Code、Open WebUI、Aider 等工具。选择集成方式
查看模型与价格
模型、服务档位和单价会变化，调用前以控制台当前目录为准。打开价格页
先分清两个地址
| 用途 | 地址 | 说明 |
|---|---|---|
| 控制台 | https://router.xiu.ai |
登录、充值、创建 API Key、查看价格和使用记录 |
| Chat Completions / Responses | https://router-api.xiu.ai/v1 |
OpenAI 兼容 SDK 和使用 Responses 的客户端 |
| Anthropic Messages | https://router-api.xiu.ai |
会自行追加 /v1/messages 的 Claude 客户端 |
| Gemini GenerateContent | https://router-api.xiu.ai |
会自行追加 /v1beta/models/... 的 Gemini 客户端 |
router-api.xiu.ai 让模型请求直连服务节点，不经过控制台的边缘转发。对中国大陆网络，这条链路通常更短、延迟更低，也更适合长流式响应。实际速度仍会受地区、运营商和当前网络影响。
router.xiu.ai/v1 仍保留兼容转发，已有配置不会立即失效。新配置应使用 router-api.xiu.ai，避免长请求受到边缘转发超时影响。
从其他 API 服务切换
如果当前客户端使用 OpenAI Chat Completions 或 Responses，通常只需要替换两项：
Base URL: https://router-api.xiu.ai/v1
API Key: 你的 XiuRouter API Key目标模型 ID 在 XiuRouter 中相同时，原模型配置可以保留；目录中没有相同 ID 时，还需要改为 XiuRouter 当前提供的模型 ID。
使用 Anthropic Messages 的客户端时，Base URL 使用 https://router-api.xiu.ai，不要追加 /v1；客户端会自行请求 /v1/messages。Gemini GenerateContent 客户端也使用 API 根地址，由客户端追加 /v1beta/models/{model}:generateContent。API Key 填入客户端对应的 Key 或 Token 配置项。接入前先查看API 兼容范围。
从哪里开始
- 第一次使用：阅读发起第一次 API 请求。
- 已有兼容客户端：按 Chat Completions、Responses、Anthropic Messages 或 Gemini GenerateContent 替换对应 Base URL 和 API Key，再确认模型 ID 可用。
- 使用 SDK：阅读使用 SDK 调用 XiuRouter，再按模型验证请求参数。
- 使用 Codex、Claude Code 或 Agent 工具：先阅读选择集成方式，不要只替换域名。
- 准备生产接入：完成错误处理与生产检查。
- 请求失败：先确认 API 地址、认证头、模型 ID、API Key 的分组和模型限制，再查使用记录。
当前边界
- 模型、分组、价格和可用性以模型与价格当前显示为准。
- 分组表示服务来源与价格，不代表速度、质量或服务等级。
- 同一个模型不一定支持所有协议。客户端协议必须和网关路由、模型能力同时匹配。
- 公共目录的协议声明当前不足以单独判断 Responses 或 Gemini 是否可用；用目标模型和分组发送小请求确认。
- 本轮核对确认了公开路由和未认证请求的拒绝行为，没有使用真实 API Key 发起计费调用。
- 不要把 API Key 写进仓库、截图、聊天记录或共享配置。
来源与核对日期
本文按 XiuRouter 当前控制台、公开状态、价格接口和 xiu-router、xiu-web 当前代码核对，日期为 2026-08-19。模型、价格和客户端版本会变化，接入时以控制台与对应项目官方文档为准。