メインコンテンツへスキップ
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
  }
]
このエンドポイントは、1 回ごとに 1 つの task id をポーリングするのではなく、Midjourney タスクをまとめて取得したい場合に使用します。

使用するタイミング

  • 複数の Midjourney タスクをまとめて追跡している
  • task の状態、送信期間、その他のサーバー側条件で絞り込みたい
  • 対話型の単一タスクのポーリングではなく、ダッシュボードや照合作業のジョブが必要

クエリパターン

1

ホットパスでは単一タスクのポーリングを使う

アクティブな task が 1 つだけの場合は、よりシンプルで高速な Fetch Single Task を使用してください。
2

バッチ確認では条件ベースの一覧取得を使う

1 回のリクエストで複数の Midjourney タスクを確認する必要がある場合は、このエンドポイントでフィルター条件を送信してください。
3

注目すべき task を追跡する

バッチ結果に、さらに詳しい確認や継続処理が必要な task が含まれている場合は、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