Tripo3D

Tripo API 소개

Tripo API 소개

Tripo3D는 텍스트-3D, 이미지-3D, 리깅, 메시 편집 및 기타 기능을 제공하는 AI- 기반 3D 생성 플랫폼입니다. Tripo API를 사용하면 개발자는 고품질 3D 콘텐츠 생성을 자체 제품에 통합할 수 있습니다.

중국에서 접속하시는 경우, 중국 사이트를 방문해주세요: developers.tripo3d.com

베이스 URL

https://openapi.tripo3d.ai/v3

인증

모든 API 요청에는 요청 헤더에 API Key가 포함되어야 합니다.

Authorization: Bearer {api_key}

Tripo 콘솔에서 API Keys를 생성하고 관리할 수 있습니다.

통합 응답 형식

성공반응

JSON
{
  "code": 0,
  "data": {
    ...
  }
}

오류 응답

JSON
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}

공통 필드

매개변수 유형 설명
code 정수 상태 코드. 0는 성공을 나타내고 0가 아닌 값은 오류를 나타냅니다.
data 물체 성공 시에만 반환되는 비즈니스 데이터
message 문자열 오류 설명, 실패 시에만 반환됨
suggestion 문자열 제안된 수정 사항, 실패 시에만 반환됨

비동기 작업 패턴

대부분의 API 세대는 비동기 작업 패턴을 사용합니다.

  1. 작업 생성 - POST 요청을 보내 작업을 생성하고 task_id를 받습니다.
  2. 결과 폴링 - GET /v3/tasks/{task_id}를 사용하여 작업 상태 및 결과를 쿼리합니다.
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}

작업 상태

상태 설명
queued 대기 중
running 달리기
success 성공함
failed 실패
cancelled 취소됨

API 버전

현재 버전: v3

엔드포인트 개요

3D 모델 생성

엔드포인트 설명
POST /v3/generation/text-to-model 텍스트에서 3D 모델 생성
POST /v3/generation/image-to-model 이미지에서 3D 모델 생성
POST /v3/generation/multiview-to-model 다중 뷰 이미지에서 3D 모델 생성

이미지 생성

엔드포인트 설명
POST /v3/generation/text-to-image 텍스트에서 이미지 생성
POST /v3/generation/image-to-image 이미지 스타일 변환
POST /v3/generation/image-to-multiview 다중뷰 이미지 생성
POST /v3/generation/edit-multiview 멀티뷰 이미지 편집

모델 처리

엔드포인트 설명
POST /v3/models/texture 모델 텍스처링
POST /v3/models/convert 모델 형식 변환
POST /v3/mesh/segment 의미론적 분할
POST /v3/mesh/complete 메시 완성
POST /v3/mesh/decimate 리토폴로지

애니메이션

엔드포인트 설명
POST /v3/animations/rig-check 리깅 호환성 확인
POST /v3/animations/rig 모델 조작
POST /v3/animations/retarget 애니메이션 대상 변경

작업 관리

엔드포인트 설명
GET /v3/tasks/{task_id} 작업 쿼리
POST /v3/tasks/list 일괄적으로 작업 쿼리

파일 관리

엔드포인트 설명
POST /v3/files 파일 업로드

계정

엔드포인트 설명
GET /v3/account/balance 계좌 잔액 조회