错误码与排错建议

本页用于快速定位常见失败原因。

常见状态码

400 Bad Request：请求参数错误或字段格式不符合要求

401 Unauthorized：API Key 无效、缺失或鉴权格式错误

403 Forbidden：权限不足，或该 Key 无访问能力

404 Not Found：接口路径错误或模型路由不存在

429 Too Many Requests：请求频率超限或额度受限

500/502/503：上游异常或网关临时故障

优先排查顺序

1.

检查 Base URL 是否为 https://api.jmlt.asia

2.

检查 Authorization 是否为 Bearer YOUR_API_KEY 格式

3.

检查模型名称是否存在且当前 Key 有权限

4.

检查账户余额、额度限制与频率限制

5.

检查请求体字段名和字段类型

重试策略建议

对 429 和 5xx：指数退避重试（例如 1s/2s/4s）

对 400/401/403/404：先修正配置或参数再重试

每次失败建议记录：状态码、请求 ID（如有）、模型名、关键参数

修改于 2026-05-21 17:04:50

鉴权与请求规范