POST /v1/3d/generations는 TokenLab 작업을 생성하며, 완료 상태 응답은 model_url과 같은 다운로드 가능한 모델 자산을 반환하고, 사용 가능한 경우 형식별 URL을 반환합니다.
입력 유형 선택
어떤 옵션을 노출할지 결정하기 전에 모델 카탈로그를 쿼리하십시오:
이 endpoint에서는
operation 필드가 아니라 입력 유형을 사용합니다. 모델 metadata는 3D 기능을 text-to-3d 및/또는 image-to-3d로 표시합니다. 3d-generation은 공개 request operation이 아닙니다.
tripo-h3.1과 프로덕션 스타일 3D 자산 생성용 tripo-p1.0을 포함합니다. 선택한 모델의 입력 유형과 출력 형식 지원 여부는 Models API로 확인하세요.
모든 3D 모델이 두 가지 입력 유형을 지원하거나 모든 출력 형식을 지원한다고 가정하지 마십시오. image, image_url, format, quality, style, 또는 seed를 전송하기 전에 선택한 모델 계약을 확인하십시오.
3D 작업 생성
image_url을 사용하십시오. 클라이언트가 의도적으로 비공식 미디어를 전송하고 백엔드가 더 큰 요청 본문을 처리할 준비가 되어 있을 때만 인라인/base64 image를 사용하십시오.
출력 형식 선택
glb는 일반적으로 웹 미리보기를 위한 가장 안전한 기본값입니다.fbx및obj는 선택한 모델이 이를 지원할 때 DCC 파이프라인에 유용합니다.usdz는 모델이 노출할 때 Apple AR 워크플로우에 유용합니다.- 더 높은
quality값은 대기 시간과 비용을 증가시킬 수 있습니다. 이를 숨겨진 기본값이 아닌 명시적인 사용자 선택으로 노출하십시오. seed는 모델이 이를 존중할 때만 재현 가능성에 유용합니다.
자산 폴링 및 저장
반환된poll_url을 먼저 사용하십시오. 클라이언트가 고정 경로가 필요하면 GET /v1/tasks/{id}를 사용하십시오.
model_url을 반환하며 glb_url, fbx_url, obj_url, 또는 usdz_url을 포함할 수 있습니다. 사용자가 반복 접근, 버전 기록 또는 장기 다운로드가 필요할 경우 선택한 자산을 다운로드하거나 캐시하십시오.
생산 체크리스트
task_id,poll_url, 모델, 요청된 형식 및 자신의 자산 기록 ID를 유지하십시오.- 페이지 새로 고침 후에는 중복 작업을 생성하는 대신 폴링을 재개하십시오.
- 작업을 생성하기 전에 소스 이미지 크기와 접근 가능성을 검증하십시오.
- 사용자가 자산에 접근할 권한이 없는 한 생성된 자산 URL을 공개 페이지에 두지 마십시오.
- 나중에 조정을 위해 존재할 경우
billing_transaction_id를 기록하십시오.