# 일괄 작업 쿼리
하나의 요청으로 여러 비동기 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` 작업 IDs 아래에 각 배치를 유지합니다.
- `missed` 항목을 삭제하기 전에 ID와 계정/API 키를 확인하세요.
- 대용량 폴링의 경우 모든 작업이 여전히 `queued` 또는 `running` 상태일 때 물러납니다.
일괄 작업 쿼리
하나의 요청으로 여러 비동기 Tripo 작업을 쿼리합니다. 이는 애플리케이션이 일괄 3D 생성 또는 처리 작업을 제출하고 해당 상태를 함께 새로 고쳐야 할 때 유용합니다.
엔드포인트
HTTP
POST /v3/tasks/list
요청 본문
필드
유형
필수
설명
task_ids
문자열[]
필수
쿼리할 작업 ID입니다. 요청당 최대 100 ID입니다.
각 값은 작업 생성 응답에서 반환된 UUID여야 합니다. 형식이 잘못된 ID가 하나라도 있으면 전체 요청이 HTTP 400 / 코드 1004로 거절됩니다.