# 모델 및 버전

## 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"}'
```