# 작업 쿼리

`task_id`를 통해 하나의 비동기 Tripo 작업의 상태, 진행률 및 출력을 쿼리합니다.

모든 생성, 메시 처리, 리깅, 애니메이션, 파일 가져오기 및 변환 끝점은 `task_id`를 반환합니다. 이 엔드포인트를 사용하여 작업이 `success`, `failed` 또는 `cancelled`에 도달할 때까지 폴링합니다.

## 엔드포인트

```http
GET /v3/tasks/{task_id}
```

## 경로 매개변수

| 이름 | 유형 | 필수 | 설명 |
| --- | --- | --- | --- |
| `task_id` | 문자열 | 필수 | 작업 생성 엔드포인트에서 반환된 고유 작업 식별자입니다. 일반적으로 `task_`로 시작합니다. |

## 요청 예시

```bash
curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123
```

## 응답 필드

| 필드 | 유형 | 설명 |
| --- | --- | --- |
| `task_id` | 문자열 | 고유한 작업 식별자입니다. |
| `type` | 문자열 | `text_to_model`, `image_to_model`, `rig` 또는 `convert`와 같은 작업 유형입니다. |
| `status` | 문자열 | `queued`, `running`, `success`, `failed` 또는 `cancelled` 중 하나입니다. |
| `progress` | 정수 | `0`에서 `100`까지 작업이 진행됩니다. |
| `output` | 물체 | `status=success`일 때 채워집니다. `model_url`, `rendered_image_url` 또는 기타 작업별 자산이 포함될 수 있습니다. |
| `credits_consumed` | 정수 | 완료된 작업에 사용된 크레딧입니다. |
| `created_at` | 문자열 | ISO 8601 생성 시간. |
| `completed_at` | 문자열 | ISO 8601 완료 시간(사용 가능한 경우). |

## 상태 처리

- `queued` 및 `running`를 미완성 상태로 처리합니다.
- `status=success` 이후에만 출력 자산을 다운로드하세요.
- `failed` 또는 `cancelled`를 사용자에게 표시하고 입력을 변경하지 않고 재시도 루프를 방지합니다.