> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Liệt kê tác vụ Midjourney
> POST /mj/task/list-by-condition liệt kê các tác vụ Midjourney theo bộ lọc để lấy trạng thái cho một hoặc nhiều job, bao gồm tiến độ và kết quả.
Sử dụng endpoint này khi bạn cần truy xuất hàng loạt tác vụ Midjourney thay vì thăm dò từng task id một.
## Khi nào nên dùng
* Bạn đang theo dõi nhiều tác vụ Midjourney cùng lúc
* Bạn muốn lọc theo trạng thái tác vụ, khoảng thời gian gửi, hoặc các điều kiện phía máy chủ khác
* Bạn cần một dashboard hoặc job đối soát thay vì thăm dò tương tác cho từng tác vụ
## Mẫu truy vấn
Với một tác vụ đang hoạt động, hãy ưu tiên [Fetch Single Task](./fetch-single-task), vì cách này đơn giản và nhanh hơn.
Gửi các điều kiện lọc của bạn qua endpoint này khi bạn cần kiểm tra nhiều tác vụ Midjourney trong một request.
Khi kết quả hàng loạt cho thấy các tác vụ cần kiểm tra sâu hơn hoặc cần tiếp tục xử lý, hãy chuyển lại sang [Fetch Single Task](./fetch-single-task) và [Action](../action).
Dùng route này cho các job giám sát và đối soát; dùng [Fetch Single Task](./fetch-single-task) cho luồng thăm dò tương tác chính.
## OpenAPI
````yaml api/openapi/image/midjourney/task-fetching-api/post-list-by-condition.openapi.json POST /mj/task/list-by-condition
openapi: 3.1.0
info:
title: List by Condition API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/mj/task/list-by-condition:
post:
summary: List by Condition
operationId: list_by_condition
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- ids
properties:
ids:
type: array
description: >-
Array of Midjourney task ids to retrieve. Returns the
current status and result for each.
items:
type: string
default:
- example
default:
ids:
- example
examples:
Default:
summary: Fetch several tasks by id
value:
ids:
-
-
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
action:
type: string
description: >-
Task type: `IMAGINE`, `UPSCALE`, `VARIATION`,
`DESCRIBE`, `BLEND`, `VIDEO`, or another action name.
buttons:
type: array
items:
type: object
properties:
customId:
type: string
emoji:
type: string
label:
type: string
style:
type: integer
type:
type: integer
description: >-
Action buttons available on the finished task. Send a
button's `customId` together with this task's id to
`/mj/submit/action` to upscale, vary, zoom, or pan.
description:
type: string
description: Human-readable submission status message.
failReason:
type: string
description: Failure reason when `status` is `FAILURE`.
finishTime:
type: integer
description: Completion time as a Unix timestamp in milliseconds.
id:
type: string
description: Task id.
imageUrl:
type: string
description: >-
Stable CometAPI-proxied image link
(`https://api.cometapi.com/mj/image/{id}`). Prefer this
link; entries in `image_urls` point at provider storage
and can expire.
progress:
type: string
description: >-
Progress percentage string such as `58%` while the task
runs and `100%` when finished.
prompt:
type: string
description: Original prompt as submitted.
promptEn:
type: string
description: >-
Prompt after translation to the provider language. For
`DESCRIBE` tasks, the extracted prompt suggestions
arrive here.
properties:
type: object
properties: {}
description: Additional task metadata, such as `finalPrompt`.
startTime:
type: integer
description: >-
Processing start time as a Unix timestamp in
milliseconds.
state:
type: string
description: >-
Custom state string echoed back from the submission for
your own tracking.
status:
type: string
description: >-
Task lifecycle state: `NOT_START`, `SUBMITTED`,
`IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
submitTime:
type: integer
description: Submission time as a Unix timestamp in milliseconds.
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/mj/task/list-by-condition \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": ["", ""]
}'
- lang: Python
label: Default
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/mj/task/list-by-condition",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={"ids": ["", ""]},
)
for task in response.json():
print(task["id"], task["action"], task["status"], task.get("progress"))
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/mj/task/list-by-condition", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ ids: ["", ""] }),
});
for (const task of await response.json()) {
console.log(task.id, task.action, task.status, task.progress);
}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````