메인 콘텐츠로 건너뛰기
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
  }
]
이 엔드포인트는 task id를 하나씩 폴링하는 대신 Midjourney 작업을 일괄 조회해야 할 때 사용합니다.

​
사용 시점

  • 여러 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