跳转到主要内容
POST
/
mj
/
task
/
list-by-condition
List by Condition
curl --request POST \
  --url https://api.cometapi.com/mj/task/list-by-condition \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "example"
  ]
}
'
[
  {
    "action": "<string>",
    "buttons": [
      {
        "customId": "<string>",
        "emoji": "<string>",
        "label": "<string>",
        "style": 123,
        "type": 123
      }
    ],
    "description": "<string>",
    "failReason": "<string>",
    "finishTime": 123,
    "id": "<string>",
    "imageUrl": "<string>",
    "progress": "<string>",
    "prompt": "<string>",
    "promptEn": "<string>",
    "properties": {},
    "startTime": 123,
    "state": "<string>",
    "status": "<string>",
    "submitTime": 123
  }
]
当你需要批量获取 Midjourney 任务,而不是一次只轮询一个 task id 时,请使用此端点。

何时使用

  • 你需要同时跟踪多个 Midjourney 任务
  • 你希望按任务状态、提交时间窗口或其他服务端条件进行筛选
  • 你需要仪表盘或对账任务,而不是交互式的单任务轮询

查询模式

1

对热路径使用单任务轮询

对于单个活跃任务,优先使用 Fetch Single Task,因为它更简单也更快。
2

对批量检查使用基于条件的列表查询

当你需要在一次请求中检查多个 Midjourney 任务时,通过此端点发送你的筛选条件。
3

继续跟进值得关注的任务

当批量结果显示某些任务需要更深入检查或继续处理时,切换回 Fetch Single TaskAction
将此路由用于监控和对账任务;主要的交互式轮询路径请使用 Fetch Single Task

授权

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
ids
string[]
必填

Array of Midjourney task ids to retrieve. Returns the current status and result for each.

响应

200 - application/json

Success

action
string
buttons
object[]
description
string
failReason
string
finishTime
integer
id
string
imageUrl
string
progress
string
prompt
string
promptEn
string
properties
object
startTime
integer
state
string
status
string
submitTime
integer