错误

错误响应是具有一致结构的 JSON：

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Daily quota exceeded",
    "retryable": false
  }
}

code 是一个稳定的、机器可读的字符串——在客户端代码中据此分支处理是安全的。message 是供人阅读的文本，其措辞可能会随时间变化。目前实践中你会遇到的一些 code：RATE_LIMITED、MODEL_NOT_ALLOWED、CONVERSATION_NOT_FOUND、QUOTA_EXCEEDED、INVALID_REQUEST、FILE_REQUIRED、UNSUPPORTED_FILE_TYPE、FILE_SCAN_FAILED、FILE_NOT_FOUND、PLAN_NOT_FOUND、PLAN_NOT_PURCHASABLE。

一个失败的 chat 请求永远不会将供应商的原始错误信息或内部错误信息流式传给客户端——你会收到一条通用消息和一个 reference id，真实的细节会被记录在服务端日志中。