Midjourney 提交 modal 任务 API 接口文档

概念介绍

Modal 任务用于在 Midjourney 生成过程中进行细节修改。

当其他任务返回 code 21 时，表示需要调用此接口传入新的提示词来调整图像细节。

接口地址

POST https://www.dmxapi.cn/mj/submit/modal

请求参数

参数名	类型	必填	说明
taskId	string	是	需要修改的任务ID
prompt	string	否	新的提示词，用于指导细节修改
maskBase64	string	否	局部重绘的蒙版base64编码
noStorage	boolean	否	True: 返回原始图片链接

示例代码

import requests
import json

# API 接口地址
url = "https://www.dmxapi.cn/mj/submit/modal"
API_KEY = "sk-******************************"  # 填入你的 DMXAPI 令牌

# 构建请求数据
payload = json.dumps({
   "prompt": "新的提示词内容",  # 用于修改细节的提示词
   "taskId": "14001934816969359"  # 需要修改的任务ID
})

# 设置请求头
headers = {
   'Authorization': f'Bearer {API_KEY}',  # 身份验证
   'Content-Type': 'application/json'
}

# 发送POST请求
response = requests.request("POST", url, headers=headers, data=payload)

# 输出响应结果
print(response.text)

响应说明

{
    "code": 1,
    "description": "提交成功",
    "properties": {},
    "result": 1756141991905216  # 去第二步任务查询API，获得结果
}

注意事项

1. 此接口需要在收到 code 21 响应后调用
2. taskId 必须为有效的任务ID
3. 蒙版参数 maskBase64 用于指定局部重绘区域
4. 身份验证通过 Bearer Token 实现