问题与下一步
XiuRouter API、Key、模型、价格、用量和请求失败常见问题
先用公开页面确认当前事实，再进入控制台或 Docs 完成操作。这里不保存固定模型数量、价格或可用性承诺。
协议与 API Key
先按客户端协议选入口，再确认 Key 的服务档位与模型范围。
应该选择 Responses、Chat Completions、Messages 还是 Gemini？
按客户端实际发送的协议选择，不按模型品牌猜。Codex 当前走 Responses，Claude Code 走 Anthropic Messages，只支持 OpenAI-compatible Chat 的工具走 Chat Completions，Gemini 原生 SDK 走 GenerateContent。最终以协议说明和目标客户端文档为准。
一把 API Key 能否用于多个协议？
同一把 Key 可以用于它被授权的模型与服务档位，但能否调用某条协议还取决于目标模型当前声明的端点类型。创建 Key 时先确认模型范围，再用对应协议发一条小请求验证。
API 请求应该发到 router.xiu.ai 还是 router-api.xiu.ai？
新的 SDK 和客户端配置应使用文档给出的 router-api.xiu.ai 地址。router.xiu.ai 是公开站和控制台域名，保留部分历史兼容路径，但不应作为新接入的默认 API Origin。
在哪里创建 API Key 并验证第一次请求？
在控制台的 API 密钥页创建并保存 Key，模型 ID 与服务档位从当前模型与价格页核对。完整的请求参数、示例和验证步骤由快速开始文档维护。
模型与服务档位
目录会随当前可调用情况变化，内容页不保存第二份模型清单。
XiuRouter 当前支持哪些模型？
以模型与价格页的当前公开目录为准。它直接显示当前模型 ID、服务档位、协议声明和价格；FAQ 不写固定模型数量，也不把历史目录当作当前可用性。
服务档位代表速度、质量或稳定性等级吗？
服务档位决定当前可选模型与价格来源。档位名称本身不构成速度、质量、稳定性、故障转移或 SLA 保证；应以目标模型的一次真实请求和后续使用记录判断。
模型 ID 从哪里获取？
从当前模型与价格页复制精确模型 ID；支持自动发现的客户端也可以读取 /v1/models。不要根据营销名称自行拼接模型 ID。
模型在目录中可见，为什么请求仍可能失败？
目录可见只说明当前公开目录能描述这个模型。请求还要同时满足协议、Key 状态、模型范围、服务档位、余额和当时的上游响应。按请求记录逐项核对，不把目录可见解释为永久可用。
价格与用量
当前单价与已经发生的结算是两类证据，应分别核对。
在哪里查看当前价格？
模型与价格页读取当前公开价格接口，按模型和服务档位展示。需要机器读取时使用 /api/pricing；内容页不抄一份固定价目表。
输入、输出、缓存读取和缓存写入价格有什么区别？
它们是不同用量维度的每 1M tokens 单价，只有目标模型和请求实际产生的维度才参与结算；按次计费的模型会单独标记。
厂商参考价和 XiuRouter 档位价格有什么区别？
厂商参考价用于同模型的公开价格比较，不是 XiuRouter 的结算价。实际结算使用请求命中的模型、服务档位和对应输入、输出及缓存单价。
同一模型为什么在不同服务档位下费用不同？
服务档位对应不同服务来源和单价。若 Key 配置了自动档位或跨档重试，最终承接请求的档位决定价格；以使用记录里的实际档位与结算为准。
如何核对一条请求的 Token 和费用？
在控制台使用记录中按 API Key、请求时间或请求 ID 查找，核对模型、服务档位、输入、输出、缓存用量、状态和结算。当前价格页用于解释单价，使用记录用于证明已经发生的结果。
常见请求失败
先保存错误、时间和请求 ID，再判断是协议、Key、模型还是上游问题。
出现 404 时为什么要先检查 Base URL 和路径？
不同 SDK 会自动补不同路径。常见错误是把 /v1 写进 Base URL 后，客户端又补一次 /v1，或把 Responses、Messages、Chat、Gemini 的路径混用。按协议页核对最终请求 URL。
出现 model not found 或无可用模型时怎么处理？
从当前价格页重新复制模型 ID，确认目标服务档位仍列出该模型，并检查 Key 的模型范围。若目录或上游状态变化，换用当前可选组合后再做一条小请求。
超时、断流或没有收到完整回答时能否直接重试？
先到使用记录确认上一条请求是否已到达并产生结算，再决定是否重试。保留请求 ID 和已收到的输出；客户端没拿到完整回答不等于请求从未发生。
文本回复正常，但工具调用或文件修改失败，说明什么？
这通常说明基础文本路径已通，但客户端专有工具协议、流式事件或所选模型的工具能力没有满足任务。按客户端文档核对支持边界，并用更小的工具任务单独验证。
Agent 与客户端
客户端名称相同也可能有桌面、CLI、IDE 等不同配置面。
Codex 应该走哪条接入路径？
当前 Codex 路径使用 OpenAI Responses，并通过本地 provider 配置选择 XiuRouter。它影响新建的本地 Codex 任务，不改变云端 ChatGPT 会话。
Claude Code 为什么不直接套用 OpenAI Base URL？
Claude Code 使用 Anthropic Messages 语义，客户端会自己拼 /v1/messages，因此网关根地址与 OpenAI SDK 的 /v1 Base URL 写法不同。按当前 Claude Code 文档配置。
Cursor 接入后所有功能都会走 XiuRouter 吗？
不会。当前 Base URL 覆盖主要影响相应 OpenAI-compatible 模型路径；Cursor 专有模型、Tab 补全和其它专有能力仍可能走 Cursor 自己的服务。Ask 可用也不自动证明 Agent 文件修改可用。
其它 Agent 或客户端如何判断能否接入？
先确认它是否允许自定义 Base URL 和 API Key，再确认它实际发送 Responses、Messages、Chat Completions 或 Gemini 中的哪一种。满足后仍要用目标模型做一次真实请求和使用记录核对。
生产检查与支持
把目录、真实请求和使用记录连起来，才构成可交付的生产证据。
上线前至少应该验证哪些内容？
确认最终请求 URL、认证头、模型 ID、服务档位和当前单价；发送一条小请求；在使用记录中核对状态、Token 与费用；再为超时、限额和上游失败设置应用侧处理。
价格页可见是否等于稳定性或 SLA 保证？
不等于。价格页证明当前目录与单价，不证明永久可用率、延迟、质量或故障转移。生产方案需要自己的重试、降级、监控和成本边界。
什么时候看 Router 页面，什么时候看 Docs？
Router 页面回答适合什么场景、选哪种协议、当前模型与价格在哪里；Docs 回答具体参数、配置步骤、验证、恢复和排障。动态事实以公开接口和当前页面为准。
自助排查后仍未解决，应该提供哪些信息？
通过站内客服提交发生时间、请求 ID、客户端、协议、模型 ID、服务档位和错误文本。不要发送完整 API Key；如需识别 Key，只提供控制台显示的名称或摘要。