# 错误码 (/docs/api/native/media/errors)



[指南 →](/docs/cloud/services/media/quickstart)

自有 API 返回 error.code、error.message、error.details。兼容接口返回 error.message，并通过 X-Cld-Error 响应头重复消息；非 ASCII 消息在响应头中使用百分号编码。

| 领域码 | 自有 HTTP | 兼容 HTTP | 可重试 |
| --- | --- | --- | --- |
| LIBRARY_NOT_FOUND | 404 | 404 | 否 |
| ASSET_NOT_FOUND | 404 | 404 | 否 |
| JOB_NOT_FOUND | 404 | 404 | 否 |
| UNDERSTANDING_NOT_FOUND | 404 | 404 | 否 |
| LIBRARY_INVALID_STATE | 409 | 400 | 否 |
| INVALID_PARAMS | 400 | 400 | 否 |
| INVALID_EXPRESSION | 400 | 400 | 否 |
| UNSUPPORTED | 400 | 400 | 否 |
| NOT_IMPLEMENTED | 501 | 400 | 否 |
| FILE_TOO_LARGE | 413 | 400 | 否 |
| FILE_EMPTY | 400 | 400 | 否 |
| UNSUPPORTED_MEDIA | 415 | 400 | 否 |
| FETCH_FAILED | 400 | 400 | 否 |
| LIMIT_EXCEEDED | 400 | 400 | 否 |
| CHUNK_INVALID | 400 | 400 | 否 |
| RATE_LIMITED | 429 | 420 | 是 |
| CAPACITY | 503 | 500 | 是 |
| UPSTREAM_FAILED | 502 | 500 | 是 |

可重试错误采用退避重试；其它错误先修正请求或资源状态。

## 模型配置错误 [#模型配置错误]

* 400 `INVALID_PARAMS`：模型调用 ID 不存在（`Model <id> is not available`）、vision 模型不支持图片输入，或 models 含未知角色、空白 ID 或不合法的值。
* 409 `LIBRARY_INVALID_STATE`：库中已有素材时更换 embedding，包括恢复默认值导致模型改变。消息为「库中已有素材时不能更换嵌入模型」。
* 502 `UPSTREAM_FAILED`：写入模型配置时无法查询模型目录；可退避重试。