テキストから 3D モデルへ — P シリーズ

POST /v3/generation/text-to-model

P シリーズモデルを使用して、テキストプロンプトから 3D モデルを生成します。 P シリーズは、クリーンで洗練されたトポロジーを備えたクラス最高のローポリ生成向けに最適化されており、ゲームアセット、様式化されたコンテンツ、軽量 3D ワークフローに最適です。

標準との主な違い

ローポリ出力向けに最適化（P1-20260311: 50 ～ 20,000 面、P2-20260801: 最大 50,000 面）
構造化トポロジによるメッシュ生成は約 2 秒
quad は P2-20260801 のみ対応。smart_low_poly、generate_parts、geometry_quality はサポートしません

リクエストパラメータ

パラメータ	種類	必須	デフォルト	説明
prompt	文字列	必須	-	テキストプロンプト、最大 1024 文字
negative_prompt	文字列	オプション	-	否定プロンプト、最大 255 文字
image_seed	整数	オプション	ランダム	テキストから画像への段階のランダムシード
model	文字列	必須	-	P シリーズのモデルバージョン。P シリーズを呼び出すには必ず指定してください。省略した場合、リクエストはデフォルトの H シリーズモデル `v3.1-20260211` で実行されます。値: `P1-20260311`（ローポリ向けに最適化）、`P2-20260801`（次世代、クワッド出力に対応。プレビュー版）
model_seed	整数	オプション	ランダム	ジオメトリ生成用のランダムシード
face_limit	整数	オプション	適応的な	最大ポリ数。`P1-20260311`: 50 ～ 20,000、`P2-20260801` 三角面: 48 ～ 50,000、`quad=true` の場合: 48 ～ 25,000
texture	ブール値	オプション	本当の	テクスチャマップを有効にする
pbr	ブール値	オプション	本当の	PBR マテリアルマップを有効にします。テクスチャを強制 = true
texture_seed	整数	オプション	ランダム	テクスチャ生成用のランダムシード
texture_quality	文字列	オプション	標準	`fast`（`texture_version=v3.5-20260815` が必要）、`standard`、`detailed`、または `extreme`
texture_version	文字列	オプション	model から導出	テクスチャモデルを指定します: `v3.5-20260815`、`v3.0-20250812`、または `v2.5-20250123`。P シリーズのジオメトリでは既定で `v3.0-20250812` です。
delight	ブール値	オプション	true	テクスチャリング前に参照画像の焼き込まれた照明を除去します。`texture_version=v3.5-20260815` の場合のみ有効です。
auto_size	ブール値	オプション	偽	現実世界の寸法 (メートル) に合わせてスケールする
export_uv	ブール値	オプション	本当の	UV のラッピングを解除します。 false = より速く、より小さいファイル
export_orientation	文字列	オプション	`+x`	輸出方向。使用可能な値: `-x`、`-y`、`+y`
quad	ブール値	オプション	false	`P2-20260801` のみ。三角面ではなくクワッドメッシュを出力します。出力形式は `FBX` に強制されます。`face_limit` 未指定時の既定値は 10,000 面です。

export_orientation に関する注意:

この生成にのみ適用されます。後処理タスク（テクスチャ、リグ、リターゲット、変換など）でモデルを使用する場合は、このパラメータを設定しないことをお勧めします。
設定した場合、後処理でモデルの向きが誤っているため最終結果に影響する可能性がありますが、タスクは引き続き status: success を報告します — エラーは発生しません。慎重に使用してください。
モデルを後処理する予定がある場合は、このパラメータを設定せず、最後のステップで /v3/models/convert を使って向きを変換してください。

例

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P1-20260311",
  "face_limit": 3000,
  "texture": true,
  "texture_quality": "detailed"
}

P2-20260801（クワッド出力）:

JSON

{
  "prompt": "a low poly medieval sword",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}

応答

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}