# モデルとバージョン

## 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` | Google | 高速生成 |
| `gemini-3-pro` | Google | 高品質の生成 |
| `gemini-3.1-flash` | Google | 最新の高速バージョン |
| `chat_image_1` | OpenAI | GPT イメージの生成 |
| `chat_image_1.5` | OpenAI | GPT高品質 |
| `chat_image_2` | OpenAI | 最新の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"}'
```