# 原生错误处理

> 各原生入口的错误包装与常见 HTTP 状态。

<a id="native-errors-section-1"></a>

## 错误形状

原生错误包装不同，应结合 HTTP 状态读取：

| 入口 | 典型错误形状 |
| --- | --- |
| Seedream / OpenAI 图片 | `error.message/type/code`，具体字段以模型返回为准 |
| Seedance | `{"error":{"code":"invalid_request","message":"..."}}` |
| Gemini 原生 | 通常为 Gemini 的 `error` 对象；鉴权、额度等错误由平台返回 |
| MiniMax H3 | `{"type":"error","error":{"type":"bad_request_error","message":"...","http_code":"400"},"request_id":"..."}` |
| 可灵现代原生 | `{"code":400,"message":"...","request_id":"..."}` |
| Midjourney 兼容 | 参数和提交错误使用 `error`；鉴权和限流错误使用平台通用格式 |

常见 HTTP 含义：400 参数/路径/模型能力不符，401 密钥无效，403 无权限（平台管理账号的密钥为 `platform_management_not_consumer`），402 预算不足，429 限流，5xx 为平台或模型服务异常；部分入口的预算不足也可能返回 400，请同时读取错误正文。Seedance/H3 查询不存在或不属于当前账号的任务时返回 400 `task_not_exist`，不要统一假定为 404。

下载产物时按对应模型页的说明使用返回地址。上游产物链接和平台签名下载地址自带读取授权，均不附带平台虚拟密钥；只有文档明确要求鉴权的平台下载接口才携带平台虚拟密钥。不能仅凭地址是相对路径就判断是否需要鉴权，也不要把密钥转发给第三方产物域名。