选择模型并核对价格与用量

模型目录、服务分组和价格会独立变化。调用前先用目标 API Key 读取模型，再到价格页核对同一模型在对应服务档位中的当前价格。

价格页将不同来源和价格选择称为“服务档位”；API Key 和使用记录中称为“服务分组”。两处指向同一个分组值，本文按你当前操作的页面使用对应名称。

读取可用模型

curl https://router-api.xiu.ai/v1/models \
  -H "Authorization: Bearer $XIUROUTER_API_KEY"

返回列表受以下条件共同限制：

• 账号当前可用的服务分组。
• API Key 绑定或自动选择的服务分组。
• API Key 的模型范围。
• 当前有可用渠道的模型。

同一个账号的两把 Key 可能看到不同列表。生产配置应保存精确模型 ID，不要只按厂商名或页面展示名匹配。

核对协议

价格目录会发布模型可用的端点类型，但最终仍要用目标 Key 验证：

网关还存在图片、Embeddings、音频、Rerank 和 Moderation 路由。它们的可用性取决于模型和服务来源；当前文档没有把这些路由列为通用生产能力。Files、Fine-tuning 和图片 Variations 当前未实现。

核对价格

打开模型与价格，完成以下检查：

1. 搜索精确模型 ID。
2. 选择与 API Key 服务分组对应的服务档位。
3. 确认该服务档位可用。
4. 查看按 Token 或按次计费。
5. 按 Token 计费时，分别看输入、输出、缓存读取和缓存写入。
6. 需要对比时，再看厂商参考价；实际扣费以 XiuRouter 当前服务分组价格和使用记录为准。

服务档位表示来源和价格选择，不代表固定速度、质量或 SLA。API Key 使用自动分组时，系统可能在失败后尝试下一个分组，最终承接请求的分组决定价格。

核对使用记录

发送请求后，打开 XiuRouter“使用记录”。每条记录可用于核对：

• 请求时间和请求 ID。
• API Key 名称和 public ID。
• 模型和实际服务分组。
• 输入、输出 Token。
• 执行费用和费用状态。
• 流式或非流式。
• 首字、总耗时和请求结果。

失败或未知结果先刷新记录。没有请求 ID、Token 或费用时，不要用 0 或客户端估算值代替缺失事实。

建议流程

1. 在价格页选择模型和服务档位。
2. 为项目创建专用 Key，并限制模型和剩余额度。
3. 通过 GET /v1/models 确认 Key 能看到目标模型。
4. 用项目实际协议发送小请求。
5. 在使用记录核对模型、分组、Token、费用和结果。
6. 通过后再提高并发、上下文和任务权限。

来源与核对日期

本文按 XiuRouter 当前模型列表路由、公开价格目录、API Key 范围和使用记录字段核对，日期为 2026-08-19。模型、分组和价格不写死在文档中，以控制台当前显示为准。