可观测性与故障排查

使用 Token360 控制台可以从账户级异常定位到单个请求，同时避免暴露密钥或敏感内容。

Dashboard

Dashboard 可以展示请求数、成功率、可用率、TTFT、端到端延迟、吞吐、Token 用量、费用、模型分布和错误分类等指标。可用维度取决于账户类型和所选时间范围。

使用趋势图回答：

• 问题只影响一个模型还是所有模型？
• 失败是否从某个 UTC 时间开始？
• 问题属于延迟、限流、参数校验还是供应商可用性？
• 同期请求量或 Token 吞吐是否发生变化？

请求与日志

从 Requests 或 Logs 视图打开一个请求，可以查看可用的模型、状态、耗时、用量、费用、供应商路由和关联 ID。由于保留、隐私、归档或账户策略，提示词和生成内容可能不可见。

程序化排查可使用 API 参考中的生成记录与计费对账接口。

关联 ID

返回时请记录：

• 响应体中的 request 或 generation ID；
• X-Request-Id；
• X-Trace-ID；
• 异步任务、Batch、图片或视频资源 ID。

这些标识用于关联客户端日志、Token360 请求记录、计费记录和支持调查。不要把 API Key 密钥用作关联标识。

排查顺序

1. 本地校验请求。 确认 JSON、Content-Type、端点、模型名和必填字段。
2. 检查鉴权与策略。 确认 Key 已启用、未过期、符合 IP 策略并获准访问模型。
3. 检查消费控制。 查看 Key 上限、每日消费保护、钱包余额和信用额度。
4. 分类响应。 结合 HTTP 状态、error.type、error.code 和可选 service code。
5. 判断影响范围。 对比其他请求，并在安全时对比另一模型，判断是单请求问题还是整体问题。
6. 执行文档化重试策略。 仅重试瞬时错误。
7. 带证据升级。 向支持提供时间戳和关联 ID。

常见现象

支持材料

请提供：

• UTC 起止时间；
• 公开模型名和端点；
• request、trace 与资源 ID；
• HTTP 状态和错误码；
• 是否使用流式；
• 脱敏后的请求结构；
• 客户端 SDK 与版本。

请勿提供 API Key 密钥、Authorization 请求头、密码、支付信息或未脱敏的个人数据。