# 批量任务查询
**Base URL:** `https://openapi.tripo3d.ai/v3`
**Endpoint:** `POST /tasks/list`
在单次请求中批量查询多个异步任务的状态和输出。返回以 task_id 为键的任务详情 map,以及未找到的任务 ID 列表。
## Request Parameters
### task_ids
- **Type:** string[]
- **Required:** 必选
要查询的任务 ID 数组。每次请求最多 **100** 个。
示例: `["task_abc123", "task_def456"]`
## Response Fields
### tasks
- **Type:** object
- **Required:** 必选
以 task_id 为键的任务详情 map。每个值的结构与单任务查询响应相同。
### missed
- **Type:** string[]
- **Required:** 必选
未找到的任务 ID 列表(无效 ID、错误的 API Key 或已过期)。
## Request Example
### 批量查询
```bash
curl --request POST \
--url https://openapi.tripo3d.ai/v3/tasks/list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"task_ids": [
"task_abc123",
"task_def456"
]
}'
```
## Response Example
### 批量结果
```json
{
"code": 0,
"data": {
"tasks": {
"task_abc123": {
"task_id": "task_abc123",
"type": "text_to_model",
"status": "success",
"progress": 100,
"credits_consumed": 100.00
},
"task_def456": {
"task_id": "task_def456",
"type": "image_to_model",
"status": "running",
"progress": 60
}
},
"missed": []
}
}
```
请求参数
请求体
task_idsstring[]必选
要查询的任务 ID 数组。每次请求最多 100 个。
示例: ["task_abc123", "task_def456"]
返回参数
tasksobject必选
以 task_id 为键的任务详情 map。每个值的结构与单任务查询响应相同。
missedstring[]必选
未找到的任务 ID 列表(无效 ID、错误的 API Key 或已过期)。
示例
{
"task_ids": [
"task_abc123",
"task_def456"]
}
{
"code": 0,
"data": {
"tasks": {
"task_abc123": {
"task_id": "task_abc123",
"type": "text_to_model",
"status": "success",
"progress": 100,
"credits_consumed": 100.00
},
"task_def456": {
"task_id": "task_def456",
"type": "image_to_model",
"status": "running",
"progress": 60
}
},
"missed": []
}
}