Skip to main content
Ace Data Cloud 的响应结构因调用类型而异,主要分两类:
  1. 同步 HTTP 响应 ——POST /xxx 请求的直接返回
  2. Webhook 回调主体 ——异步任务完成后,POST 给你的 callback_url
两者的成功/失败字段约定不完全一样,请分别看。

同步响应:成功

成功时返回上游业务字段,通常包含一个 success: true 标记。具体字段以各 API 的 API 参考 为准。 例(Midjourney /midjourney/imagine):

同步响应:失败

错误响应没有 success 字段,仅含 errortrace_id

Webhook 回调主体

如果调用时传了 callback_url,任务完成后我们 POST 一个 JSON 到该地址。回调主体的约定与同步响应不同——总是包含 success 字段: 成功回调:
失败回调:
回调用普通 HTTP POST 投递,当前不带签名。请确保 callback_url 不易被外部猜中,或在自己的服务端校验 task_id 是否属于已发起的任务。

HTTP 状态码

真实存在的错误码

下面列出的都来自 PlatformGateway 异常定义。其它服务路径上的上游错误码(例如 Midjourney 自身的 task_failed)以各 API 文档为准。

重试建议

  • 4xx 一般不要自动重试(429 除外),先看 error.message 修请求
  • 429 / 5xx 可以重试,使用带抖动的指数退避
  • trace_id 记到你的日志里,定位问题最快

上报问题

报障时请同时提供:
  1. trace_id
  2. 请求 URL、Headers(去掉 Token 后半段)、Body
  3. 响应 Status + Body
入口:platform.acedata.cloud 工单 / support@acedata.cloud / 状态页