# 일괄 작업 쿼리

하나의 요청으로 여러 비동기 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` 작업 IDs 아래에 각 배치를 유지합니다.
- `missed`를 사용하여 애플리케이션 상태에서 오래된 작업 ID를 정리합니다.
- 대용량 폴링의 경우 모든 작업이 여전히 `queued` 또는 `running` 상태일 때 물러납니다.