# バッチタスククエリ
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` になっているときにバックオフしてください。
バッチタスククエリ
1 つのリクエストで複数の非同期 Tripo タスクをクエリします。これは、アプリケーションが 3D 生成または処理タスクのバッチを送信し、それらの状態をまとめて更新する必要がある場合に便利です。
エンドポイント
リクエストボディ
| フィールド |
種類 |
必須 |
説明 |
task_ids |
文字列[] |
必須 |
タスク ID をクエリします。リクエストごとの最大 100 ID。 |
リクエスト例
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 になっているときにバックオフしてください。
