跳轉到主要內容
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 Task 和 Action。
將此路由用於監控與對帳作業；主要的互動式輪詢流程請使用 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