常见问题
API 接入、价格用量与数据隐私常见问题
涵盖 API 协议与密钥、模型与服务档位、价格与用量、数据保留与隐私权利，以及请求故障排查。
协议与 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？
新接入使用 router-api.xiu.ai。OpenAI Chat Completions 和 Responses 的 Base URL 是 https://router-api.xiu.ai/v1；Anthropic Messages 和 Gemini GenerateContent 使用 https://router-api.xiu.ai。router.xiu.ai 用于网站和控制台。
在哪里创建 API Key 并验证第一次请求？
登录控制台，进入 API Key，创建 Key 并选择服务档位、模型范围、额度和有效期。复制模型 ID 后发送一条短请求，再到使用记录确认模型、档位、Token、状态和费用。
模型与服务档位
模型与价格页列出当前可用的精确型号、协议和单价，调用权限还取决于 API Key。
XiuRouter 当前支持哪些模型？
XiuRouter 提供 Claude、GPT 等模型 API。调用前从模型与价格页复制当前可用的精确型号，核对 API Key 权限、协议和单价。支持某种请求格式，不代表该格式对应厂商的所有模型均可调用。
服务档位代表速度、质量或稳定性等级吗？
服务档位决定当前可选模型与价格来源。档位名称本身不构成速度、质量、稳定性、故障转移或 SLA 保证；应以目标模型的一次真实请求和后续使用记录判断。
模型 ID 从哪里获取？
从当前模型与价格页复制精确模型 ID；支持自动发现的客户端也可以读取 /v1/models。不要根据营销名称自行拼接模型 ID。
模型在目录中可见，为什么请求仍可能失败？
目录可见只说明当前公开目录能描述这个模型。请求还要同时满足协议、Key 状态、模型范围、服务档位、余额和当时的上游响应。按请求记录逐项核对，不把目录可见解释为永久可用。
价格与用量
当前单价与已经发生的结算是两类证据，应分别核对。
在哪里查看当前价格？
在模型与价格页按模型和服务档位查看；需要机器读取时使用 /api/pricing。
输入、输出、缓存读取和缓存写入价格有什么区别？
它们是不同用量维度的每 1M tokens 单价，只有目标模型和请求实际产生的维度才参与结算；按次计费的模型会单独标记。
厂商参考价和 XiuRouter 档位价格有什么区别？
厂商参考价用于同模型的公开价格比较，不是 XiuRouter 的结算价。实际结算使用请求命中的模型、服务档位和对应输入、输出及缓存单价。
同一模型为什么在不同服务档位下费用不同？
服务档位对应不同服务来源和单价。若 Key 配置了自动档位或跨档重试，最终承接请求的档位决定价格；以使用记录里的实际档位与结算为准。
如何核对一条请求的 Token 和费用？
在控制台使用记录中按 API Key、请求时间或请求 ID 查找，核对模型、服务档位、输入、输出、缓存用量、状态和结算。当前价格页用于解释单价，使用记录用于证明已经发生的结果。
数据与隐私
模型对话、调用统计与账户信息分别适用不同的处理规则。
XiuRouter 是否存储模型对话内容？
XiuRouter 不存储提示词、历史消息、文件、图片及模型回复。对话内容仅用于完成模型请求的处理和传输。
调用记录包含哪些信息？
调用记录包括模型、请求时间、Token 用量、缓存计量、费用、请求结果和时延。调用统计与模型性能数据长期保留，用于计费核对、历史用量查询和性能分析。
XiuRouter 是否使用对话训练模型或出售用户数据？
XiuRouter 不使用模型对话内容训练模型，不出售任何用户数据。
XiuRouter 的上游接入政策是什么？
XiuRouter 的上游接入政策为仅接入大模型厂商自营服务。
模型厂商如何处理请求数据？
模型厂商按对应服务的数据政策处理请求，包括训练用途、安全日志、数据保留与缓存规则。具体模型和功能的适用条款可通过隐私支持查询。
如何提出个人信息访问、导出或删除请求？
个人信息访问、更正、导出或删除请求可发送至 contact@xiu.ai，注明相关账户、信息范围及请求事项。我们将按需核验身份或授权，依据适用法律处理并反馈结果。
常见请求失败
先保存错误、时间和请求 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 保证？
不等于。价格页证明当前目录与单价，不证明永久可用率、延迟、质量或故障转移。生产方案需要自己的重试、降级、监控和成本边界。
XiuRouter 和 ChatGPT、Claude 网页订阅有什么区别？
XiuRouter 是按 API 用量计费的模型调用服务，通过 API Key 接入应用和 Agent；ChatGPT、Claude 等网页订阅面向对应产品的聊天界面和账号功能，通常不包含可在其它应用中使用的 API 额度。
自助排查后仍未解决，应该提供哪些信息？
通过站内客服提交发生时间、请求 ID、客户端、协议、模型 ID、服务档位和脱敏后的错误信息，不应包含对话原文或完整 API Key。如需识别 Key，仅提供控制台显示的名称或摘要。