错误码
ModelPort API 文档
使用说明
根据 HTTP 状态和响应里的错误码处理请求失败。
| HTTP | 常见错误 | 处理 |
|---|---|---|
| 400 | 参数不符合接口约束 | 核对模型可选字段和请求格式。 |
| 401 | 密钥缺失、无效或已撤销 | 检查请求头和控制台密钥。 |
| 402 | 可用余额不足 | 先查询余额。 |
| 404 | 资源不存在或不属于当前账户 | 核对编号和密钥。 |
| 409 | 幂等键冲突或原请求处理中 | 使用原编号查询，改变参数时使用新键。 |
| 422 | 规格未定价或费用超限 | 重新获取所选规格报价。 |
| 503 | 当前模型或上游暂不可用 | 检查可调用状态和最新报价。 |
媒体任务错误
图片、视频、音频和 3D 的任务查询及失败回调使用 failCode 返回标准错误类别，failure.code 和 error 提供原错误码。failMsg 说明原因。任务已明确失败且 retryable 为 true 时，可重新报价并使用新的幂等键提交。
| 类别 | 处理 |
|---|---|
| CONTENT_MODERATION / INVALID_INPUT | 检查提示词、参数或参考文件。 |
| UPSTREAM_BUSY / UPSTREAM_FAILED / UPSTREAM_UNAVAILABLE / TIMEOUT | 根据返回的 retryable 决定是否重新报价，持续失败时保留任务编号。 |
| RECONCILIATION_REQUIRED | 继续查询原任务。 |
| RESULT_EXPIRED / CANCELLED | 在调用账单确认预扣已退回。 |
| OTHER | 记录任务编号和错误码。 |