# テキストから 3D モデルへ — P シリーズ
> **POST** `/v3/generation/text-to-model`
P シリーズ モデルを使用して、テキスト プロンプトから 3D モデルを生成します。 P シリーズは、クリーンで洗練されたトポロジーを備えたクラス最高のローポリ生成向けに最適化されており、ゲーム アセット、様式化されたコンテンツ、軽量 3D ワークフローに最適です。
## 標準との主な違い
- 低い顔数 (48 ~ 20,000) 向けに最適化
- 構造化トポロジによるメッシュ生成は約 2 秒
- **サポートしません**: `quad`、`smart_low_poly`、`generate_parts`、`geometry_quality`
## リクエストパラメータ
| パラメータ | 種類 | 必須 | デフォルト | 説明 |
| :-: | :-: | :-: | :-: | :-: |
| prompt | 文字列 | 必須 | - | テキスト プロンプト、最大 1024 文字 |
| negative_prompt | 文字列 | オプション | - | 否定プロンプト、最大 255 文字 |
| image_seed | 整数 | オプション | ランダム | テキストから画像への段階のランダム シード |
| model | 文字列 | オプション | トリポ-P1 | Pシリーズのモデルバージョン。値: `tripo-p1` |
| model_seed | 整数 | オプション | ランダム | ジオメトリ生成用のランダム シード |
| face_limit | 整数 | オプション | 適応的な | 最大ポリ数。範囲: **48 ~ 20,000** |
| texture | ブール値 | オプション | 本当の | テクスチャ マップを有効にする |
| pbr | ブール値 | オプション | 本当の | PBR マテリアル マップを有効にします。テクスチャを強制 = true |
| texture_seed | 整数 | オプション | ランダム | テクスチャ生成用のランダム シード |
| texture_quality | 文字列 | オプション | 標準 | `standard`、`detailed`、または `extreme` |
| auto_size | ブール値 | オプション | 偽 | 現実世界の寸法 (メートル) に合わせてスケールする |
| compress | 文字列 | オプション | - | 圧縮タイプ: `geometry` (meshopt) |
| export_uv | ブール値 | オプション | 本当の | UV のラッピングを解除します。 false = より速く、より小さいファイル |
## 例
```json
{
"prompt": "a low poly medieval sword",
"model": "tripo-p1",
"face_limit": 3000,
"texture": true,
"texture_quality": "detailed"
}
```
## 応答
```json
{
"code": 0,
"data": {
"task_id": "task_abc123"
}
}
```
テキストから 3D モデルへ — P シリーズ
POST /v3/generation/text-to-model
P シリーズ モデルを使用して、テキスト プロンプトから 3D モデルを生成します。 P シリーズは、クリーンで洗練されたトポロジーを備えたクラス最高のローポリ生成向けに最適化されており、ゲーム アセット、様式化されたコンテンツ、軽量 3D ワークフローに最適です。
標準との主な違い
- 低い顔数 (48 ~ 20,000) 向けに最適化
- 構造化トポロジによるメッシュ生成は約 2 秒
- サポートしません:
quad、smart_low_poly、generate_parts、geometry_quality
リクエストパラメータ
| パラメータ |
種類 |
必須 |
デフォルト |
説明 |
| prompt |
文字列 |
必須 |
- |
テキスト プロンプト、最大 1024 文字 |
| negative_prompt |
文字列 |
オプション |
- |
否定プロンプト、最大 255 文字 |
| image_seed |
整数 |
オプション |
ランダム |
テキストから画像への段階のランダム シード |
| model |
文字列 |
オプション |
トリポ-P1 |
Pシリーズのモデルバージョン。値: tripo-p1 |
| model_seed |
整数 |
オプション |
ランダム |
ジオメトリ生成用のランダム シード |
| face_limit |
整数 |
オプション |
適応的な |
最大ポリ数。範囲: 48 ~ 20,000 |
| texture |
ブール値 |
オプション |
本当の |
テクスチャ マップを有効にする |
| pbr |
ブール値 |
オプション |
本当の |
PBR マテリアル マップを有効にします。テクスチャを強制 = true |
| texture_seed |
整数 |
オプション |
ランダム |
テクスチャ生成用のランダム シード |
| texture_quality |
文字列 |
オプション |
標準 |
standard、detailed、または extreme |
| auto_size |
ブール値 |
オプション |
偽 |
現実世界の寸法 (メートル) に合わせてスケールする |
| compress |
文字列 |
オプション |
- |
圧縮タイプ: geometry (meshopt) |
| export_uv |
ブール値 |
オプション |
本当の |
UV のラッピングを解除します。 false = より速く、より小さいファイル |
例
{
"prompt": "a low poly medieval sword",
"model": "tripo-p1",
"face_limit": 3000,
"texture": true,
"texture_quality": "detailed"}
応答
{
"code": 0,
"data": {
"task_id": "task_abc123"}
}