通用约定与任务查询

动作由路径决定，没有统一的 action 字段：

也支持带模式前缀的写法 POST /{mode}/mj/submit/{action}，{mode} 由渠道配置决定；不确定时用不带前缀的路径。

The action is carried by the path; there is no shared action field:

A mode-prefixed form POST /{mode}/mj/submit/{action} also works; {mode} comes from the channel config. Use the unprefixed path when unsure.

所有提交接口返回同一种信封：

{
  "code": 1,
  "description": "提交成功",
  "result": "1320098173412546"
}

• code (integer) — 1 表示成功，22 表示排队中，其他值为错误。
• description (string) — 状态描述，失败时是原因。
• result (string) — 任务 ID，后续查询与动作都用它。

Every submit endpoint returns the same envelope:

{
  "code": 1,
  "description": "提交成功",
  "result": "1320098173412546"
}

• code (integer) — 1 means success, 22 means queued, anything else is an error.
• description (string) — a status description; the failure reason when it failed.
• result (string) — the task ID, used for later queries and actions.

查询接口返回任务对象，关键字段如下：

• id / status / progress — 任务 ID、状态、进度（带百分号）。
• imageUrl / imageUrls — 主图与图片列表，四宫格时 4 张。
• action — 任务类型，如 IMAGINE、UPSCALE。
• prompt / promptEn — 原始与规范化后的提示词。
• failReason — 失败原因，仅失败时非空。
• buttons — 可执行动作，含 customId、label、emoji。
• submitTime / startTime / finishTime — 毫秒时间戳。

The fetch endpoints return a task object with these key fields:

• id / status / progress — task ID, status, and a percent string.
• imageUrl / imageUrls — the main image and the list; four for a grid.
• action — task type such as IMAGINE or UPSCALE.
• prompt / promptEn — the original and normalized prompt.
• failReason — the failure reason, empty on success.
• buttons — available actions with customId, label, emoji.
• submitTime / startTime / finishTime — milliseconds.

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

For more status codes see Error codes and rate limits; for troubleshooting see the FAQ.

提交后查询

imagine 返回任务 ID 后，轮询 /mj/task/{id}/fetch 直到 status 为 SUCCESS 或 FAILURE。

批量查询

一次查多个任务，适合列表页的状态刷新。

Submit then fetch

After imagine returns a task ID, poll /mj/task/{id}/fetch until status is SUCCESS or FAILURE.

Batch query

Fetch several tasks at once, handy for refreshing a list view.