使用场景
一个 API 接入 Claude、GPT 等模型
支持 Responses、Chat Completions、Anthropic Messages 和 Gemini GenerateContent。按实际用量计费，可用于 Agent、已有应用迁移和多模型调用。
XiuRouter 能直接解决什么
用同一套账号和 API Key 调用主流模型，按客户端原生协议接入，并按实际请求用量计费。
- 模型
- 模型与价格页当前列出的可用型号。
- 协议
- Responses、Chat Completions、Anthropic Messages 和 Gemini GenerateContent。
- Base URL
- OpenAI 类客户端使用 https://router-api.xiu.ai/v1；Messages 和 Gemini 客户端使用 https://router-api.xiu.ai。
- 计费
- 按模型、服务档位和实际输入、输出、缓存用量计费；按次计费的模型会单独标记。
你现在要完成什么
找到当前任务后，先按卡片里的协议、地址和检查项操作；需要完整配置时再打开对应指南。
在 Codex、Claude Code 或 Cursor 中调用模型
Codex 使用 Responses，Claude Code 使用 Anthropic Messages，Cursor 的自定义模型通常使用 Chat Completions。OpenAI 类客户端填写 https://router-api.xiu.ai/v1，Claude Code 填写 https://router-api.xiu.ai。
- 创建允许目标模型和服务档位的 API Key
- 填写 Base URL、API Key 和模型 ID，再完成一个真实小任务
迁移已有 OpenAI 应用
把 Base URL 改为 https://router-api.xiu.ai/v1，把凭据换成 XiuRouter API Key，再使用当前目录中的模型 ID。已有 OpenAI SDK 和 Chat Completions 代码通常不需要重写业务流程。
- 先用一条短请求确认认证、模型和响应格式
- 依赖工具调用、流式或结构化输出时，再分别测试这些能力
为不同任务选择模型并控制成本
一把 Key 可以调用它被授权的多个模型。每次请求按命中的模型、服务档位以及实际输入、输出、缓存用量计费；按次计费的模型会单独标记。
- 为不同应用分别限制模型、额度和有效期
- 在使用记录中查看每次请求的 Token、档位和费用
排查请求失败或费用异常
401 或 403 先查认证头、Key 范围、余额和服务档位；404 先查 Base URL 是否重复拼接 /v1；超时或断流先看使用记录，确认上一条请求是否已经发生。
- 保留发生时间、请求 ID、模型 ID、服务档位和脱敏后的错误信息
- 不要在结果未确认时连续重试或轮换 Key
四步完成第一次调用
充值后创建范围明确的 Key，发送一条小请求，再查看实际记录。
- 1. 充值
- 选择当前可用的支付方式，为账户增加 USD 余额。
- 2. 创建 Key
- 设置服务档位、模型范围、额度和有效期。
- 3. 发送请求
- 使用匹配的 Base URL、API Key 和精确模型 ID。
- 4. 查看记录
- 确认模型、档位、Token、状态、延迟和费用。