素材库
错误码
错误体、状态与重试规则。
自有 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：写入模型配置时无法查询模型目录；可退避重试。