# 批量任务查询
**Base URL:** `https://openapi.tripo3d.ai/v3`
**Endpoint:** `POST /tasks/list`
在单次请求中批量查询多个异步任务的状态和输出。返回以 task_id 为键的任务详情 map,以及未找到的任务 ID 列表。
## Request Parameters
### task_ids
- **Type:** string[]
- **Required:** 必选
要查询的任务 ID 数组。每次请求最多 **100** 个。
示例: `["123e4567-e89b-42d3-a456-426614174000","987e6543-e21b-42d3-a456-426614174000"]`
## Response Fields
### tasks
- **Type:** object
- **Required:** 必选
以 task_id 为键的任务详情 map。每个值的结构与状态均与[单任务查询](https://developers.tripo3d.ai/zh/docs/task-query)响应相同。
### missed
- **Type:** string[] | null
- **Required:** 可选
当前认证客户端未找到的任务 ID。全部找到时,该字段可能为 null 或被省略。任务 ID 格式无效时,请求会失败。
## 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": [
"123e4567-e89b-42d3-a456-426614174000",
"987e6543-e21b-42d3-a456-426614174000"
]
}'
```
## Response Example
### 批量结果
```json
{
"code": 0,
"data": {
"tasks": {
"123e4567-e89b-42d3-a456-426614174000": {
"task_id": "123e4567-e89b-42d3-a456-426614174000",
"type": "text_to_model",
"status": "success",
"progress": 100,
"credits_consumed": 100.00
},
"987e6543-e21b-42d3-a456-426614174000": {
"task_id": "987e6543-e21b-42d3-a456-426614174000",
"type": "image_to_model",
"status": "running",
"progress": 60
}
},
"missed": null
}
}
```
请求参数
请求体
task_idsstring[]必选
要查询的任务 ID 数组。每次请求最多 100 个。
示例: ["123e4567-e89b-42d3-a456-426614174000","987e6543-e21b-42d3-a456-426614174000"]
返回参数
tasksobject必选
以 task_id 为键的任务详情 map。每个值的结构与状态均与
单任务查询响应相同。
missedstring[] | null
当前认证客户端未找到的任务 ID。全部找到时,该字段可能为 null 或被省略。任务 ID 格式无效时,请求会失败。
示例
{
"task_ids": [
"123e4567-e89b-42d3-a456-426614174000",
"987e6543-e21b-42d3-a456-426614174000"]
}
{
"code": 0,
"data": {
"tasks": {
"123e4567-e89b-42d3-a456-426614174000": {
"task_id": "123e4567-e89b-42d3-a456-426614174000",
"type": "text_to_model",
"status": "success",
"progress": 100,
"credits_consumed": 100.00
},
"987e6543-e21b-42d3-a456-426614174000": {
"task_id": "987e6543-e21b-42d3-a456-426614174000",
"type": "image_to_model",
"status": "running",
"progress": 60
}
},
"missed": null
}
}