Tripo3D

변경 내역

변경 내역

Documentation correction (2026-08)

`credits_consumed`, `balance`, and `frozen` are JSON numbers with up to two decimal places (e.g. `48.00`, `41465.00`). Parse them as floating-point or decimal values — do not use integer parsing (`int`, `parseInt`, etc.), which will fail or truncate fractional credits (e.g. VIP discounts).

v3.0 (2026-04)

새로운 API 아키텍처

  • 전용 엔드포인트가 범용 POST 엔드포인트를 대체합니다: POST /v3/generation/text-to-model와 같은 기능별 엔드포인트는 이전 범용 POST /v2/openapi/task 엔드포인트를 type 필드로 대체합니다.
  • 통합된 {input}-to-{output} 명명 규칙: 모든 세대 엔드포인트는 text-to-model, image-to-multiview 및 multiview-to-model와 같은 직관적인 이름을 사용합니다.
  • 통합 input 필드: 입력 유형을 수동으로 지정할 필요 없이 task_id, file_token 또는 URL에서 자동 입력 소스 추론을 지원합니다.
  • 중복 /openapi 경로 제거: 기본 URL가 /v2/openapi/에서 /v3/로 단순화되었습니다.
  • 텍스트-이미지 및 이미지-이미지는 전용 엔드포인트로 분리됩니다: text-to-image 및 image-to-image는 더 이상 단일 API로 결합되지 않습니다.

엔드포인트 변경

v2 엔드포인트 v3 엔드포인트
POST /v2/openapi/task 유형=text_to_model POST /v3/generation/text-to-model
POST /v2/openapi/task 유형=image_to_model POST /v3/generation/image-to-model
POST /v2/openapi/task 유형=multiview_to_model POST /v3/generation/multiview-to-model
POST /v2/openapi/task 유형=text_to_image POST /v3/generation/text-to-image
POST /v2/openapi/task 유형=generate_image POST /v3/generation/image-to-image
POST /v2/openapi/task 유형=generate_multiview_image POST /v3/generation/image-to-multiview
POST /v2/openapi/task 유형=edit_multiview_image POST /v3/generation/edit-multiview
POST /v2/openapi/task 유형=refine_model POST /v3/models/refine
POST /v2/openapi/task 유형=convert_model POST /v3/models/convert
POST /v2/openapi/task 유형=import_model POST /v3/models/import
POST /v2/openapi/task 유형=stylize_model POST /v3/models/stylize
POST /v2/openapi/task 유형=texture_model POST /v3/models/texture
POST /v2/openapi/task 유형=animate_prerigcheck POST /v3/animations/rig-check
POST /v2/openapi/task 유형=animate_rig POST /v3/animations/rig
POST /v2/openapi/task 유형=animate_retarget POST /v3/animations/retarget
POST /v2/openapi/task 유형=mesh_segmentation POST /v3/mesh/segment
POST /v2/openapi/task 유형=mesh_completion POST /v3/mesh/complete
POST /v2/openapi/task 유형=highpoly_to_lowpoly POST /v3/mesh/decimate
GET /v2/openapi/task/{task_id} GET /v3/tasks/{task_id}

필드 변경

v2 필드 v3 필드
create_time created_at
consumed_credit credits_consumed
file / file_token / url / object input로 통합됨

새로운 기능

  • POST /v3/tasks/list - 일괄 쿼리 작업
  • POST /v3/files/upload-credentials - 직접 파일 업로드 자격 증명 받기
  • GET /v3/account/usage - 사용량 세부정보 쿼리