GET
/mj/task/{id}/image-seed获取任务图片的seed
获取已完成任务图片的 Seed 值。
API Key application/json
MJ 异步任务协议
调用与返回说明
读取 获取任务图片的 Seed。MJ 接口采用“提交任务 → 保存任务 ID → 查询/回调 → 读取结果或执行后续动作”的异步模式,不是同步返回图片或视频。
请求时注意
- 所有 MJ 接口都要在 Header 中发送 Authorization: Bearer <API_KEY>。生产环境请从服务端环境变量读取 Key。
- 请求地址使用当前站点配置的 API Base URL 拼接本文 endpoint;不要把 /v1 误加到 /mj 路径,也不要重复拼接 Base URL。
- 任务必须已完成且服务端仍保留其元数据;对未完成任务获取 Seed 可能失败。
返回时注意
- 先检查 HTTP 状态,再检查响应体中的 code 或 status。提交接口的 code=1 通常表示成功接收,result 才是后续查询使用的任务 ID。
- Seed 是字符串形式返回时按字符串保存,避免在 JavaScript 等语言中发生大整数精度丢失。
- 任务查询的终态包括 SUCCESS、FAILURE、CANCEL;MODAL 表示需要继续提交 Modal。不要只根据 progress=100% 判定成功。
Request
请求
/mj/task/{id}/image-seedBody
可选GET 请求无需 JSON 请求体,只需发送页面列出的请求头和路径、查询参数。
路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
id | Path | string | 是 | 已完成任务 ID。 | TASK_ID |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key,保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
Response返回响应
HTTP 成功不等于任务成功;请继续检查响应体中的 code 或 status。返回响应 200
响应 200objectcodeinteger业务状态码。
descriptionstring结果描述。
resultstringSeed 值。
MJ 异步任务协议
调用与返回说明
读取 获取任务图片的 Seed。MJ 接口采用“提交任务 → 保存任务 ID → 查询/回调 → 读取结果或执行后续动作”的异步模式,不是同步返回图片或视频。
请求时注意
- 所有 MJ 接口都要在 Header 中发送 Authorization: Bearer <API_KEY>。生产环境请从服务端环境变量读取 Key。
- 请求地址使用当前站点配置的 API Base URL 拼接本文 endpoint;不要把 /v1 误加到 /mj 路径,也不要重复拼接 Base URL。
- 任务必须已完成且服务端仍保留其元数据;对未完成任务获取 Seed 可能失败。
返回时注意
- 先检查 HTTP 状态,再检查响应体中的 code 或 status。提交接口的 code=1 通常表示成功接收,result 才是后续查询使用的任务 ID。
- Seed 是字符串形式返回时按字符串保存,避免在 JavaScript 等语言中发生大整数精度丢失。
- 任务查询的终态包括 SUCCESS、FAILURE、CANCEL;MODAL 表示需要继续提交 Modal。不要只根据 progress=100% 判定成功。