执行动作接口

接口说明

通过第二步获取的 customId 对指定图片进行筛选和执行后续动作，支持放大图片或生成变体图片。

基础信息

• 请求方式: POST
• 接口地址: https://www.dmxapi.cn/mj/submit/action

动作类型说明

• U (Upscale): 放大选定的图片并提升细节质量
• V (Variations): 以选定图片为基础，生成四张相似风格的新图像

请求参数

参数名	类型	是否必需	说明
taskId	string	是	任务ID，从第一步生成图片接口获取
customId	string	是	动作标识符，格式: MJ::JOB::动作类型::序号::UUID
chooseSameChannel	boolean	否	是否使用同一频道下的账号，默认使用任务关联账号
notifyHook	string	否	回调地址，为空时使用全局配置
state	string	否	自定义参数
noStorage	boolean	否	true返回原始图片链接
enableRemix	boolean	否	是否使用remix模式，默认false

示例代码

import json
import requests

# 接口配置
url = "https://www.dmxapi.cn/mj/submit/action"
API_KEY = "sk-*******************************"  # 替换为您的 DMXAPI 令牌

# 请求参数
payload = json.dumps({
    "chooseSameChannel": True,
    "taskId": "1756047036547146",  # 第一步生成图片返回的任务ID
    "customId": "MJ::JOB::variation::3::07df3a99-0578-4c83-8db8-4669fd09bee6",  # 第二步获取的 customId
    "accountFilter": {
        "channelId": "",
        "instanceId": "",
        "modes": [],
        "remark": "",
        "remix": True,
        "remixAutoConsidered": True,
    },
    "notifyHook": "",  # 回调地址
    "state": "",  # 自定义状态参数
})

# 请求头
headers = {
    "Authorization": f"Bearer {API_KEY}",  # API认证
    "Accept": "application/json",
    "Content-Type": "application/json",
}

# 发送请求
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)  # 输出响应结果

返回结果

成功执行后返回任务ID，用于后续查询执行结果：

{
  "code": 1,
  "description": "Submit Success",
  "properties": null,
  "result": "1756047756072253"  # 新任务ID，用于查询执行结果。用这个任务ID去第二步拿执行后的图片。
}

注意事项

1. 使用返回的 result 字段值作为任务ID，通过查询接口获取最终生成的图片
2. Upscale动作返回单张放大图片，Variations动作返回四张变体图片
3. 建议设置合适的回调地址(notifyHook)以便异步接收处理结果