← 所有文档

READ. CONNECT. BUILD.

错误码与排查.

常见 HTTP 状态码和逐步排查方法。

API GUIDE

API 调用以服务端目录、密钥权限与可用额度为准；示例需配置真实型号与应用密钥，执行会真实计费，音视频以实际渠道配置为准。

MARKDOWN / 2 TOPICS

用量与帮助 / 错误码与排查

错误码与排查#

先看 HTTP 状态码，再看错误正文和请求日志。下面是常见情况，具体错误类型以实际部署返回为准。

常见状态码#

状态码	常见情况	排查方向
`400`	请求参数不符合接口要求	检查 JSON、模型 ID 与支持的参数
`401`	认证信息缺失或无效	检查 Bearer 请求头与密钥
`403`	请求不被允许	根据错误信息检查模型、分组与账户权限
`429`	请求受到限制	检查限流信息，按建议等待后重试
`500` / `502` / `503` / `504`	服务或上游异常	保存请求 ID，查看日志与模型状态

分步排查#

确认 Base URL，只包含一次 /v1。
使用模型广场中的完整 ID，检查模型和密钥是否属于可用分组。
缩减为最小请求，暂时去掉可选参数。
在调用日志中查看错误信息与请求 ID。
对照模型状态页，判断是否存在异常或没有样本。

errors.md

# 错误码与排查

先看 HTTP 状态码，再看错误正文和请求日志。下面是常见情况，具体错误类型以实际部署返回为准。

## 常见状态码

| 状态码 | 常见情况 | 排查方向 |
| --- | --- | --- |
| `400` | 请求参数不符合接口要求 | 检查 JSON、模型 ID 与支持的参数 |
| `401` | 认证信息缺失或无效 | 检查 Bearer 请求头与密钥 |
| `403` | 请求不被允许 | 根据错误信息检查模型、分组与账户权限 |
| `429` | 请求受到限制 | 检查限流信息，按建议等待后重试 |
| `500` / `502` / `503` / `504` | 服务或上游异常 | 保存请求 ID，查看日志与模型状态 |

## 分步排查

1. 确认 Base URL，只包含一次 `/v1`。
2. 使用模型广场中的完整 ID，检查模型和密钥是否属于可用分组。
3. 缩减为最小请求，暂时去掉可选参数。
4. 在调用日志中查看错误信息与请求 ID。
5. 对照模型状态页，判断是否存在异常或没有样本。