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,
  "status": "error",
  "message": "You don't have enough credit to create this task",
  "suggestion": "Please purchase more credit",
  "request_id": "req_abc123"
}

공통 필드

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

비동기 작업 패턴

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

작업 생성 - POST 요청을 보내 작업을 생성하고 task_id를 받습니다.
결과 폴링 - 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`	계좌 잔액 조회