# 작업 쿼리 `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` 또는 기타 작업별 자산이 포함될 수 있습니다. 모델 가져오기 및 모델 입력이 `file_token` 또는 URL인 모델 후처리 작업(리깅, 텍스처, 변환 등)은 `normalize_scale`(number)도 반환합니다: 가져온 모델을 정규화할 때 적용된 스케일 계수입니다(`최종 크기 = 원본 크기 × normalize_scale`; `1.0`은 스케일 없음). | | `credits_consumed` | number | 완료된 작업에 사용된 크레딧입니다. | | `created_at` | 문자열 | ISO 8601 생성 시간. | | `completed_at` | 문자열 | ISO 8601 완료 시간(사용 가능한 경우). | ## 상태 처리 - `queued` 및 `running`를 미완성 상태로 처리합니다. - `status=success` 이후에만 출력 자산을 다운로드하세요. - `failed` 또는 `cancelled`를 사용자에게 표시하고 입력을 변경하지 않고 재시도 루프를 방지합니다.

GET /v3/tasks/{task_id}

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