检查当前服务状态
- 打开 Phaseo 状态页，查看当前事故和历史记录。
- 调用
GET /v1/health执行最基本的 Gateway 健康检查。 - 如果某个请求失败，请保留其 request ID 并检查活动记录或生成记录，再判断整个服务是否不可用。
公共状态页会报告服务健康情况。Phaseo 目前未承诺具有合同约束力的公共正常运行时间 SLA。
确认模型是否可路由
Phaseo 目录收录的模型多于 Gateway 当前可用的模型。模型出现在目录中只表示 Phaseo 正在跟踪该模型，并不代表存在公共路由。GET /v1/models 默认只返回当前可路由的模型：
availability=all。除非 availability_status 为 active 且 is_active_gateway 为 true，否则不要向该提供商路由发送生产流量。
可用性并不保证服务始终在线、所有地区都能访问，也不保证各工作区的商业条款完全相同。
解读性能指标
Phaseo 的性能数据属于观测数据：它汇总经由 Gateway 路由的请求，而非受控实验室基准测试的结果。
TTFT 和输出速度需要流式响应，并且首个输出必须包含内容。非流式请求仍可用于测量耗时和有效吞吐量，但不应虚构 TTFT。
查看指标时，始终结合时间范围、路由、地区、流式模式和百分位数。提供商负载、提示词长度、输出长度、重试次数和传输条件都可能改变结果。
完整定义请参阅 价格与性能 和Phaseo 如何衡量延迟和吞吐量.
使用你的工作负载进行验证
公共遥测只能提供参考，不能证明路由满足你的生产目标。上线前应进行小规模、可复现的测试：- 移除敏感的生产数据，并保留有代表性的提示词组合。
- 记录模型 ID、端点、提供商限制、地区、流式模式和并发数。
- 运行足够多次，以便比较分布，而不是只看单个请求。
- 记录成功率、Gateway TTFT、提供商耗时、Gateway E2E、输出 token 数和最终成本。
- 测试无效密钥、无效模型、速率限制和提供商不可用导致的失败。
- 保存 request ID 和准确的时间范围，以便其他工程师复现结果。
排查失败的请求
- 查看 服务状态。
- 确认该模型仍显示在
GET /v1/models的默认响应中。 - 查看以下内容中的 HTTP 状态和错误代码：错误处理.
- 临时遇到
429和5xx错误时，请采用有界指数退避后重试。 - 联系支持团队时，请保留请求 ID。