# バッチタスククエリ
1 つのリクエストで複数の非同期 Tripo タスクをクエリします。これは、アプリケーションが 3D 生成または処理タスクのバッチを送信し、それらの状態をまとめて更新する必要がある場合に便利です。
## エンドポイント
```http
POST /v3/tasks/list
```
## リクエストボディ
| フィールド | 種類 | 必須 | 説明 |
| --- | --- | --- | --- |
| `task_ids` | 文字列[] | 必須 | タスク ID をクエリします。リクエストごとの最大 `100` ID。 |
各値にはタスク作成応答の UUID を使用します。不正な形式の ID が一つでもあると、リクエスト全体が HTTP 400 / コード `1004` で拒否されます。
## リクエスト例
以下の UUID は例です。実際のタスク作成応答から返された `task_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":["123e4567-e89b-42d3-a456-426614174000","123e4567-e89b-42d3-a456-426614174001"]}'
```
## 応答フィールド
| フィールド | 種類 | 説明 |
| --- | --- | --- |
| `tasks` | オブジェクト | `task_id` をキーとするマップ。各値はタスク クエリと同じ構造を使用します。 |
| `missed` | string[] / null | 形式は正しいが、見つからないか現在の API キーでアクセスできないタスク ID。 要求したすべての ID が見つかった場合、`missed` は `null` または省略されることがあります。 |
## 注意事項
- 各バッチを `100` タスク ID の下に保持します。
- `missed` の項目を削除する前に、ID とアカウント/API キーを確認してください。
- 大量のポーリングの場合は、すべてのタスクがまだ `queued` または `running` になっているときにバックオフしてください。
バッチタスククエリ
1 つのリクエストで複数の非同期 Tripo タスクをクエリします。これは、アプリケーションが 3D 生成または処理タスクのバッチを送信し、それらの状態をまとめて更新する必要がある場合に便利です。
エンドポイント
リクエストボディ
| フィールド |
種類 |
必須 |
説明 |
task_ids |
文字列[] |
必須 |
タスク ID をクエリします。リクエストごとの最大 100 ID。 |
各値にはタスク作成応答の UUID を使用します。不正な形式の ID が一つでもあると、リクエスト全体が HTTP 400 / コード 1004 で拒否されます。
リクエスト例
以下の UUID は例です。実際のタスク作成応答から返された task_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":["123e4567-e89b-42d3-a456-426614174000","123e4567-e89b-42d3-a456-426614174001"]}'
応答フィールド
| フィールド |
種類 |
説明 |
tasks |
オブジェクト |
task_id をキーとするマップ。各値はタスク クエリと同じ構造を使用します。 |
missed |
string[] / null |
形式は正しいが、見つからないか現在の API キーでアクセスできないタスク ID。 要求したすべての ID が見つかった場合、missed は null または省略されることがあります。 |
注意事項
- 各バッチを
100 タスク ID の下に保持します。
missed の項目を削除する前に、ID とアカウント/API キーを確認してください。
- 大量のポーリングの場合は、すべてのタスクがまだ
queued または running になっているときにバックオフしてください。