Midjourney 绘图大模型 API 任务查询接口

MJ 查询接口地址

GET https://www.dmxapi.cn/mj/task/{task_id}/fetch

模型版本信息

请查在返回示例里查看，当前（2025-08-21）是 v7 版本

参数说明

参数名	类型	必填	说明
task_id	string	是	任务ID，提交绘图任务时返回的唯一标识

认证方式

需要在请求头中添加 API Key:

Authorization: Bearer sk-******

示例代码

import requests

任务ID = "1755752048939155" # 上一步提交任务获得的任务ID
API_KEY = "sk-*********************************"  # 替换为你 DMXAPI 令牌
url = f"https://www.dmxapi.cn/mj/task/{任务ID}/fetch"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.request("GET", url, headers=headers)
print(response.text)

返回示例

默认情况下，你会获得8个 customId ,下一步调整图片API接口会用到。

{
  "id": "1755752048939155",
  "action": "IMAGINE",
  "customId": "",
  "botType": "",
  "prompt": "cat and dog.",
  "promptEn": "cat and dog.",
  "description": "Submit Success",
  "state": "",
  "mode": "",
  "proxy": "",
  "submitTime": 1755752048939,
  "startTime": 1755752053140,
  "finishTime": 1755752133256,
  "imageUrl": "https://mj.gptnbcdn1.xyz/attachments/1372468820912115716/1407951252645478513/cat_dog_d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b.png?ex=68a7f849&is=68a6a6c9&hm=8f3651aa1a139f015d99f58ab87140d7ab178e0d471fb43db3b84f4480792b18&",
  "imageUrls": [
    {
      "url": "https://cdn.midjourney.com/d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b/0_0.png"
    },
    {
      "url": "https://cdn.midjourney.com/d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b/0_1.png"
    },
    {
      "url": "https://cdn.midjourney.com/d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b/0_2.png"
    },
    {
      "url": "https://cdn.midjourney.com/d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b/0_3.png"
    }
  ],
  "imageHeight": 1024,
  "imageWidth": 1024,
  "videoUrl": "",
  "videoUrls": null,
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "U1",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::2::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "U2",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::3::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "U3",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::4::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "U4",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::reroll::0::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b::SOLO",
      "emoji": "🔄",
      "label": "",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::1::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "V1",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::2::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "V2",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::3::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "V3",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::4::d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
      "emoji": "",
      "label": "V4",
      "type": 2,
      "style": 2
    }
  ],
  "maskBase64": "",
  "properties": {
    "notifyHook": "",
    "flags": 0,
    "messageId": "",
    "messageHash": "d37b2dd3-9159-4e9b-a0f6-c7d6aaecb96b",
    "nonce": "",
    "customId": "",
    "finalPrompt": "cat and dog. --ar 1:1 --v 7 --stylize 100 --fast",
    "progressMessageId": "",
    "messageContent": "",
    "discordInstanceId": "1372468820912115716",
    "discordChannelId": "1372468820912115716"
  }
}

常见状态码

• 200: 请求成功
• 401: 认证失败
• 404: 任务不存在
• 500: 服务器错误

注意事项

1. API Key 是敏感信息，请妥善保管
2. 任务完成后会保留一定时间，请及时获取结果
3. 高峰期可能会有延迟，建议轮询查询状态