Skip to content

批量查询接口

POST  v1/mj/task/list-by-condition

通过任务id数组,查询任务信息。(可以通过轮询调用该接口,实现任务进行的查询。也可以通过回调接口获取)

请求参数

Authorization

在 Header 添加参数 Authorization,其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

返回响应

200 成功

Content-Type: application/json

响应参数

字段名类型必填说明
actionstring可选当前任务的执行动作(例如:IMAGINE 生成, UPSCALE 放大, VARIATION 变化)。
buttonsarray [object]可选关联的交互按钮列表(如 U1-U4, V1-V4 等),通常包含 customId, label, style, type, emoji 等子字段。
descriptionstring可选任务的详细描述信息。
failReasonstring可选如果任务失败,这里会包含失败的具体原因。
finishTimeinteger可选任务结束时的 Unix 时间戳。
idstring可选任务的唯一标识符(Task ID)。
imageUrlstring可选生成图片的最终访问地址(URL)。
progressstring可选任务当前的进度(例如 "100%" 或具体描述)。
promptstring可选用户输入的原始提示词。
promptEnstring可选翻译后的英文提示词(因为 Midjourney 核心模型通常使用英文)。
propertiesobject可选扩展属性对象,包含其他未列出的具体参数。
startTimeinteger可选任务开始执行时的 Unix 时间戳。
statestring可选自定义状态参数,通常由调用方传入并在回调中原样返回。
statusstring可选任务当前的状态(例如:SUBMITTED, IN_PROGRESS, FINISHED, FAILURE)。
submitTimeinteger可选任务提交时的 Unix 时间戳。
customIdstring可选按钮的唯一标识,用于后续交互回调。
emojistring可选按钮上显示的 Emoji 图标。
labelstring可选按钮上显示的文本标签。
styleinteger可选按钮的样式(如主色调、灰色等)。
typeinteger可选组件类型(如按钮类型)。

响应示例

[
    {
        "action": "IMAGINE",
        "buttons": [
            {
                "customId": "string",
                "emoji": "string",
                "label": "string",
                "style": 0,
                "type": 0
            }
        ],
        "description": "string",
        "failReason": "string",
        "finishTime": 0,
        "id": "string",
        "imageUrl": "string",
        "progress": "string",
        "prompt": "string",
        "promptEn": "string",
        "properties": {},
        "startTime": 0,
        "state": "string",
        "status": "NOT_START",
        "submitTime": 0
    }
]

示例代码

python
import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({})
headers = {
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/mj/task/list-by-condition", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))