Skip to main content
POST
/
mj
/
task
/
list-by-condition
分页查询
curl --request POST \
  --url https://api.deerapi.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
  }
]

Documentation Index

Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt

Use this file to discover all available pages before exploring further.

/mj/task/list-by-condition 用于按条件分页查看 Midjourney 任务列表。它适合后台任务管理、批量排障、用户历史记录和需要一次查看多条任务状态的场景。

第一次调用建议

先只设置分页参数和最基础的筛选条件,确认返回列表结构后再增加状态、时间或任务类型筛选。分页查询不是单任务取结果的首选接口;如果你已经有明确任务 ID,优先使用 按 ID 查询

重点看哪些字段

  • 任务 ID:用于进入后续查询或 Action 操作。
  • 任务状态:判断任务是否仍在执行,是否可以继续点击按钮。
  • 图像 URL 和按钮列表:完成后用于展示结果和触发后续操作。

下一步

拿到单个任务 ID 后,进入 按 ID 查询 查看完整任务详情。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
ids
string[]
required

Response

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