# Tripo API 소개

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

> 중국에서 접속하시는 경우, 중국 사이트를 방문해주세요: [developers.tripo3d.com](https://developers.tripo3d.com)

## 베이스 URL

```baseurl
https://openapi.tripo3d.ai/v3
```

## 인증

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

```apikey
Authorization: Bearer {api_key}
```

[Tripo 콘솔](/en/keys)에서 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`](/en/docs/generation-text-to-model) | 텍스트에서 3D 모델 생성 |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | 이미지에서 3D 모델 생성 |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | 다중 뷰 이미지에서 3D 모델 생성 |

### 이미지 생성

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

### 모델 처리

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

### 애니메이션

| 엔드포인트 | 설명 |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | 리깅 호환성 확인 |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | 모델 조작 |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | 애니메이션 대상 변경 |

### 작업 관리

| 엔드포인트 | 설명 |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | 작업 쿼리 |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | 일괄적으로 작업 쿼리 |

### 파일 관리

| 엔드포인트 | 설명 |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | 파일 업로드 |

### 계정

| 엔드포인트 | 설명 |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | 계좌 잔액 조회 |