Claude / GPT 多模型 API 网关
可用性与排错
检查 MatrixAPI Cloud 的模型列表、鉴权、额度、超时和常见 HTTP 错误。适合内部工具、业务后台和跨部门自动化系统，包含可执行步骤、配置边界、验证方法和相关排错入口。
状态检查只反映当前域名、账号和上游在检查时刻的结果，不构成持续可用性承诺。
最小检查顺序
模型列表
请求 https://matrixmodelapi.work/v1/models，确认 DNS、HTTPS、Authorization 和模型权限。
短请求
用最短 prompt 调用兼容接口，记录状态码、request id、首 token 时间和总耗时。
长连接
需要流式输出时单独验证读取超时、代理缓冲和断线重试，不要只用短请求推断生产稳定性。
| 状态 | 常见原因 | 下一步 |
|---|---|---|
| 401 / 403 | Key、账号、分组或权限不匹配。 | 重新生成当前站点 token 并查询 /v1/models。 |
| 429 | 额度、并发或上游限流。 | 降低并发、检查余额和重试退避。 |
| 500 / 502 / 503 | 路由、上游或模型暂时不可用。 | 保留时间、模型和 request id，再联系支持。 |
| 超时 / 断流 | 上下文过长、网络或代理缓冲。 | 缩短请求、配置首包/整体超时并检查流式读取。 |