# バッチタスククエリ

1 つのリクエストで複数の非同期 Tripo タスクをクエリします。これは、アプリケーションが 3D 生成または処理タスクのバッチを送信し、それらの状態をまとめて更新する必要がある場合に便利です。

## エンドポイント

```http
POST /v3/tasks/list
```

## リクエストボディ

| フィールド | 種類 | 必須 | 説明 |
| --- | --- | --- | --- |
| `task_ids` | 文字列[] | 必須 | タスク ID をクエリします。リクエストごとの最大 `100` ID。 |

## リクエスト例

```bash
curl -s -X POST https://openapi.tripo3d.ai/v3/tasks/list \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task_ids":["task_abc123","task_def456"]}'
```

## 応答フィールド

| フィールド | 種類 | 説明 |
| --- | --- | --- |
| `tasks` | オブジェクト | `task_id` をキーとするマップ。各値はタスク クエリと同じ構造を使用します。 |
| `missed` | 文字列[] | 見つからないか、期限切れになっているか、現在の API Key でアクセスできないタスク ID。 |

## 注意事項

- 各バッチを `100` タスク ID の下に保持します。
- `missed` を使用して、アプリケーションの状態から古いタスク ID を削除します。
- 大量のポーリングの場合は、すべてのタスクがまだ `queued` または `running` になっているときにバックオフしてください。