错误响应结构
平台 API 失败时会返回错误对象。不同兼容协议可能会保持对应协议的外层形态，但核心字段语义一致。对外策略
平台采用“默认穿透、证据包装”的错误输出策略。custom_parameter.public_error_trust_level 可配置为 official 或 trusted_proxy。未配置时默认为 official。HTTP 状态码
平台包装错误
以下错误由平台稳定包装，避免客户误判为自身权限或看到运营侧供给细节。
其他上游业务错误，例如内容安全、限流、超时、5xx、模型能力不支持、图片尺寸错误、上下文长度错误，第一版默认穿透或清洗后穿透，不强制统一成平台 code/type。
内容安全与生图封控
当上游明确返回内容安全或生图封控原因时，平台会尽量保留客户可理解的语义，让客户知道需要修改输入内容。 平台不会直接暴露上游内部字段，例如：
封控类错误不再默认强制改写为
content_policy_error。如果上游本身返回了清晰的内容安全 type、code 或状态码，平台会优先保留。
no_image_generated 与 usage
Gemini 图像模型可能出现“上游已处理请求、返回 usage，但最终没有生成图片”的结果。此时平台会返回 error.code=no_image_generated。
如果本次请求已经按 prompt/input tokens 完成结算，客户可见响应会附带本次 usage：
如果失败未产生计费 usage，例如本地参数校验失败、额度不足、网络失败或上游未返回 usage，则不会附带 usage。
上游错误脱敏规则
平台会保留排查所需的request_id，但会对客户响应中的上游细节做安全处理。
不会直接返回给客户的内容包括：
- 上游 API Key、账号、权限、余额、billing 或 quota 明细
- 上游供应商 SDK、异常栈、内部 RequestID、URL 或网络传输细节
- 内部渠道、分组、租户、组织或工作区名称
- 原始
bad response status code、多级 request id 链或未清洗的上游 JSON
error.request_id。平台支持团队可基于该 ID 查看内部链路和上游原始错误。