获取任务图片的seed

获取已完成任务图片的 Seed 值。

API Key HTTP

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% 判定成功。

请求示例

curl https://top.qingyuntop.ai/mj/task/{id}/image-seed \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"

请求参数

参数	位置	类型	必填	说明	示例
`Authorization`	Header	string	是	必填。Bearer API Key，例如 Bearer ${QINGYUN_TOP_API_KEY}。不要把真实 Key 写入前端、日志或代码仓库。	-
`id`	Path	string	是	已完成任务 ID。	TASK_ID

返回响应 (200)

HTTP 成功不等于任务成功；请继续检查响应体中的 code 或 status。

参数	位置	类型	必填	说明	示例
`code`	响应 JSON	integer	否	业务状态码。	-
`description`	响应 JSON	string	否	结果描述。	-
`result`	响应 JSON	string	否	Seed 值。	-

响应示例

{
  "code": 1,
  "description": "Success",
  "result": "123456789"
}

来源原始接口定义（用于追溯）

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "method": "get",
  "path": "/mj/task/{id}/image-seed",
  "description": "获取已完成任务图片的 Seed 值。",
  "parameters": {
    "header": [
      {
        "name": "Authorization",
        "type": "string",
        "required": true,
        "description": "Bearer API Key。所有 MJ 接口都必须携带；不要把真实 Key 写入前端、日志或代码仓库。",
        "sampleValue": "Bearer ${QINGYUN_TOP_API_KEY}"
      }
    ],
    "path": [
      {
        "name": "id",
        "type": "string",
        "required": true,
        "description": "已完成任务 ID。",
        "sampleValue": "TASK_ID"
      }
    ]
  },
  "responses": [
    {
      "code": 200,
      "name": "成功或业务结果",
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "业务状态码。"
          },
          "description": {
            "type": "string",
            "description": "结果描述。"
          },
          "result": {
            "type": "string",
            "description": "Seed 值。"
          }
        },
        "x-apifox-orders": [
          "code",
          "description",
          "result"
        ]
      },
      "description": "HTTP 成功不等于任务成功；请继续检查响应体中的 code 或 status。"
    }
  ],
  "responseExamples": [
    {
      "name": "规范示例",
      "mediaType": "application/json",
      "data": "{\n  \"code\": 1,\n  \"description\": \"Success\",\n  \"result\": \"123456789\"\n}"
    }
  ]
}