错误码

错误格式

三个接口面各有自己的错误形状，但都带一个稳定的机器可读标识和一个请求 id。message 是给人看的，会随语言变化，不要拿它做分支。

网关面（/v1、/v1beta、/v1/videos）返回 {error: {code, message}, request_id} 并使用真实 HTTP 状态码；控制台面（/api/v1）返回扁平信封；私有协议（/server）永远是 HTTP 200，错误在响应体里。

{
  "error": {"code": "insufficient_balance", "message": "余额不足，无法冻结本次调用。"},
  "request_id": "req_01J…"
}

{
  "code": 422,
  "error_code": "invalid_time_range",
  "message": "时间范围不合法。",
  "request_id": "req_01J…",
  "violations": []
}

• 网关面用 error.code，控制台面用 error_code，两者取值来自同一张代码表，含义一致。
• 同一个代码的 HTTP 状态码是固定的；反过来不成立，一个状态码下有多个代码。

控制台信封字段

控制台接口失败时返回下面这些字段。code 保留给早期客户端，请对 error_code 分支与本地化。

网关错误码

• 私有协议把这些代码映射成旧系统文案，例如 insufficient_balance → user remainingAmount is not enough，too_many_running_tasks → get lock failed，上游失败 → call api error。
• 4xx / 5xx 的失败调用不计费；流式响应中断时，已生成的部分按实际用量结算。

控制台错误码

• 这张表覆盖账号安全与代理批发等常见错误，不是全量清单；未列出的代码同样遵循上面的信封与状态码约定。