- 同步 HTTP 响应 ——
POST /xxx请求的直接返回 - Webhook 回调主体 ——异步任务完成后,POST 给你的
callback_url
同步响应:成功
成功时返回上游业务字段,通常包含一个success: true 标记。具体字段以各 API 的 API 参考 为准。
例(Midjourney /midjourney/imagine):
同步响应:失败
错误响应没有success 字段,仅含 error 与 trace_id:
Webhook 回调主体
如果调用时传了callback_url,任务完成后我们 POST 一个 JSON 到该地址。回调主体的约定与同步响应不同——总是包含 success 字段:
成功回调:
callback_url 不易被外部猜中,或在自己的服务端校验 task_id 是否属于已发起的任务。
HTTP 状态码
真实存在的错误码
下面列出的都来自PlatformGateway 异常定义。其它服务路径上的上游错误码(例如 Midjourney 自身的 task_failed)以各 API 文档为准。
重试建议
- 4xx 一般不要自动重试(429 除外),先看
error.message修请求 - 429 / 5xx 可以重试,使用带抖动的指数退避
- 把
trace_id记到你的日志里,定位问题最快
上报问题
报障时请同时提供:trace_id- 请求 URL、Headers(去掉 Token 后半段)、Body
- 响应 Status + Body
support@acedata.cloud / 状态页。
