错误 - Open Managed Agents

OMA 的公共 API 使用统一的兼容错误信封。

{
  "type": "error",
  "request_id": "req_01...",
  "error": {
    "type": "invalid_request_error",
    "message": "model is required"
  }
}

string

顶层对象类型。错误响应固定为 error。

string

本次请求的追踪 ID。联系部署运维人员时应一并提供。

string

稳定的错误分类，例如 authentication_error、invalid_request_error 或 not_found_error。

string

面向开发者的错误说明。不要依赖完整文案做程序分支判断。

常见状态码

只对临时网络错误、429 或明确可恢复的 5xx 执行带抖动的指数退避。校验错误、认证错误和版本冲突需要先修改请求，盲目重试不会成功。

/v1/filestore 使用 rclone-filestore 协议需要的扁平错误格式，不使用本页的通用错误信封。