# 모델 및 버전
## 3D 생성 모델
`POST /v3/generation/text-to-model` 및 `POST /v3/generation/image-to-model`와 같은 3D 생성 끝점에서 사용되는 `model` 매개변수입니다.
| 모델 ID | 설명 | 권장 사용 사례 |
| :-: | :-: | :-: |
| `tripo-p1` | 최고의 로우 폴리 성능 | 게임 파이프라인 / UGC 생성적 게임플레이 / 모바일 3D 자산 |
| `tripo-v3.1` | 최신 고정밀도 모델(기본값) | AAA 생산 파이프라인 / 3D 프린팅 및 유연한 제조 |
| `tripo-v3.0` | 이전 세대 안정 버전 | 이전 버전과의 호환성 |
| `tripo-v2.5` | 레거시 버전 | 역사적 프로젝트 호환성 |
## 이미지 생성 모델
`POST /v3/generation/text-to-image` 및 `POST /v3/generation/image-to-image` 엔드포인트에서 사용되는 `model` 매개변수입니다.
| 모델 ID | 공급자 | 특성 |
| :-: | :-: | :-: |
| `seedream_v4` | 바이트댄스 | 균형 잡힌 결과를 제공하는 기본 모델 |
| `seedream_v5` | 바이트댄스 | 품질이 향상된 최신 버전 |
| `gemini-2.5-flash` | 구글 | 빠른 생성 |
| `gemini-3-pro` | 구글 | 고품질 세대 |
| `gemini-3.1-flash` | 구글 | 최신 빠른 버전 |
| `chat_image_1` | 오픈AI | GPT 이미지 생성 |
| `chat_image_1.5` | 오픈AI | GPT 더 높은 품질 |
| `chat_image_2` | 오픈AI | GPT 최신 |
## 버전 선택 권장 사항
- **새 프로젝트**: 품질과 안정성의 최상의 균형을 위해 기본 버전인 3D용 `tripo-v3.1` 및 이미지용 `seedream_v4`를 사용합니다.
- **프로덕션 환경**: 모델 업데이트로 인한 출력 불일치를 방지하려면 특정 모델 버전을 고정하세요.
- **최고 품질**: 3D에는 `tripo-p1`를 사용하고 시나리오에 따라 이미지에는 `gemini-3-pro` 또는 `seedream_v5`를 선택합니다.
- **로우폴리곤/게임 자산**: 3D용 `tripo-p1` 사용 — 더욱 깔끔한 토폴로지 및 보다 정밀한 얼굴 수 제어
## 요청 예시
```bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'
```
모델 및 버전
3D 생성 모델
POST /v3/generation/text-to-model 및 POST /v3/generation/image-to-model와 같은 3D 생성 끝점에서 사용되는 model 매개변수입니다.
| 모델 ID |
설명 |
권장 사용 사례 |
tripo-p1 |
최고의 로우 폴리 성능 |
게임 파이프라인 / UGC 생성적 게임플레이 / 모바일 3D 자산 |
tripo-v3.1 |
최신 고정밀도 모델(기본값) |
AAA 생산 파이프라인 / 3D 프린팅 및 유연한 제조 |
tripo-v3.0 |
이전 세대 안정 버전 |
이전 버전과의 호환성 |
tripo-v2.5 |
레거시 버전 |
역사적 프로젝트 호환성 |
이미지 생성 모델
POST /v3/generation/text-to-image 및 POST /v3/generation/image-to-image 엔드포인트에서 사용되는 model 매개변수입니다.
| 모델 ID |
공급자 |
특성 |
seedream_v4 |
바이트댄스 |
균형 잡힌 결과를 제공하는 기본 모델 |
seedream_v5 |
바이트댄스 |
품질이 향상된 최신 버전 |
gemini-2.5-flash |
구글 |
빠른 생성 |
gemini-3-pro |
구글 |
고품질 세대 |
gemini-3.1-flash |
구글 |
최신 빠른 버전 |
chat_image_1 |
오픈AI |
GPT 이미지 생성 |
chat_image_1.5 |
오픈AI |
GPT 더 높은 품질 |
chat_image_2 |
오픈AI |
GPT 최신 |
버전 선택 권장 사항
- 새 프로젝트: 품질과 안정성의 최상의 균형을 위해 기본 버전인 3D용
tripo-v3.1 및 이미지용 seedream_v4를 사용합니다.
- 프로덕션 환경: 모델 업데이트로 인한 출력 불일치를 방지하려면 특정 모델 버전을 고정하세요.
- 최고 품질: 3D에는
tripo-p1를 사용하고 시나리오에 따라 이미지에는 gemini-3-pro 또는 seedream_v5를 선택합니다.
- 로우폴리곤/게임 자산: 3D용
tripo-p1 사용 — 더욱 깔끔한 토폴로지 및 보다 정밀한 얼굴 수 제어
요청 예시
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'