根据任务ID 查询任务状态

GEThttps://www.aipro2.com/mj/task/1743326750223591/fetch

查询 POST /mj/submit/imagine、/mj/submit/action 等提交的任务当前状态与结果；status 为 SUCCESS 时 imageUrl 有效，buttons 给出可执行的后续 Action（customId）。

Path 参数

• id*string
  任务 ID

  示例1743326750223591

Header 参数

• Authorizationstring
  Bearer API Key

  示例Bearer {{YOUR_API_KEY}}

请求体参数

none

• modelstring
  用于图像生成的模型。
• ninteger
  要生成的图像数。必须介于 1 和 10 之间。
• prompt*string
  所需图像的文本描述。最大长度为 1000 个字符。
• qualitystring
  将生成的图像的质量。hd创建具有更精细细节和更高一致性的图像。此参数仅支持dall-e-3.
• response_formatstring
  返回生成的图像的格式。必须是 或url之一b64_json。
• sizestring
  生成图像的大小。必须是256x256、512x512或 1024x1024之一。
• stylestring
  生成图像的大小。必须是256x256、512x512或1024x1024for之一dall-e-2。对于模型来说，必须是1024x1024、1792x1024、 或之一。1024x1792dall-e-3
• userstring
  生成图像的风格。必须是 或vivid之一natural。生动使模型倾向于生成超真实和戏剧性的图像。自然使模型生成更自然、不太真实的图像。此参数仅支持dall-e-3.

响应

application/jsonGetMjTaskFetchResponse

• action*string
  动作类型
• botType*string
  机器人 / Bot 类型
• buttons*array<object>
  后续可执行按钮 / 动作列表
• customId*string
  自定义透传 ID
• description*string
  描述
• failReason*string
  失败原因
• finishTime*integer
  完成时间
• id*string
  资源或任务 ID
• imageUrl*string
  结果图片 URL
• maskBase64*string
  蒙版图片 Base64
• progress*string
  进度（0–100 或 0–1，视平台而定）
• prompt*string
  文本提示词
• promptEn*string
  英文提示词
• properties*object
  扩展属性
• startTime*integer
  开始时间
• state*string
  自定义透传状态
• status*string
  状态
• submitTime*integer
  提交时间

代码示例cURLPythonJavaScriptGoPHP

1curl -X GET "https://www.aipro2.com/mj/task/1743326750223591/fetch" \2  -H "Authorization: Bearer <API Key>"

响应示例 · 200成功示例成功示例

1{2  "action": "IMAGINE",3  "botType": "",4  "buttons": [5    {6      "customId": "MJ::JOB::upsample::1::3785da15-4f70-4034-9128-f3ff1ac634fa",7      "emoji": "",8      "label": "U1",9      "style": 2,10      "type": 211    },12    {13      "customId": "MJ::JOB::upsample::2::3785da15-4f70-4034-9128-f3ff1ac634fa",14      "emoji": "",15      "label": "U2",16      "style": 2,17      "type": 218    },19    {20      "customId": "MJ::JOB::upsample::3::3785da15-4f70-4034-9128-f3ff1ac634fa",21      "emoji": "",22      "label": "U3",23      "style": 2,24      "type": 225    },26    {27      "customId": "MJ::JOB::upsample::4::3785da15-4f70-4034-9128-f3ff1ac634fa",28      "emoji": "",29      "label": "U4",30      "style": 2,31      "type": 232    },33    {34      "customId": "MJ::JOB::reroll::0::3785da15-4f70-4034-9128-f3ff1ac634fa::SOLO",35      "emoji": "🔄",36      "label": "",37      "style": 2,38      "type": 239    },40    {41      "customId": "MJ::JOB::variation::1::3785da15-4f70-4034-9128-f3ff1ac634fa",42      "emoji": "",43      "label": "V1",44      "style": 2,45      "type": 246    },47    {48      "customId": "MJ::JOB::variation::2::3785da15-4f70-4034-9128-f3ff1ac634fa",49      "emoji": "",50      "label": "V2",51      "style": 2,52      "type": 253    },54    {55      "customId": "MJ::JOB::variation::3::3785da15-4f70-4034-9128-f3ff1ac634fa",56      "emoji": "",57      "label": "V3",58      "style": 2,59      "type": 260    },61    {62      "customId": "MJ::JOB::variation::4::3785da15-4f70-4034-9128-f3ff1ac634fa",63      "emoji": "",64      "label": "V4",65      "style": 2,66      "type": 267    }68  ],69  "customId": "",70  "description": "Submit success",71  "failReason": "",72  "finishTime": 1730621855817,73  "id": "1730621826053455",74  "imageUrl": "https://cdnmjp.oneabc.org/attachments/1300842274347028520/1302547211321741343/kennedyhernandez46715_74108_pig_3785da15-4f70-4034-9128-f3ff1ac634fa.png?ex=6728831f&is=6727319f&hm=f6d701914d608e4da9298d2290b3616317264a70635fbf08a37ca6c1bb671b50&",75  "maskBase64": "",76  "progress": "100%",77  "prompt": "pig --v 6.1",78  "promptEn": "pig --v 6.1",79  "properties": {80    "finalPrompt": "pig --v 6.1",81    "finalZhPrompt": ""82  },83  "startTime": 1730621828024,84  "state": "",85  "status": "SUCCESS",86  "submitTime": 173062182605387}