Tripo3D

일괄 작업 쿼리

일괄 작업 쿼리

하나의 요청으로 여러 비동기 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 상태일 때 물러납니다.