画像から 3D モデルへ — P シリーズ

POST /v3/generation/image-to-model

P シリーズモデルを使用して画像から 3D モデルを生成します。クリーンなトポロジーによるローポリ生成用に最適化されています。

標準との主な違い

ローポリ出力向けに最適化（P1-20260311: 50 ～ 20,000 面、P2-20260801: 最大 50,000 面）
quad は P2-20260801 のみ対応。smart_low_poly、generate_parts、geometry_quality はサポートしません

リクエストパラメータ

パラメータ	種類	必須	デフォルト	説明
input	文字列	必須	-	画像ソース。 file_token、URL、または task_id を受け入れます
model	文字列	必須	-	P シリーズのモデルバージョン。P シリーズを呼び出すには必ず指定してください。省略した場合、リクエストはデフォルトの H シリーズモデル `v3.1-20260211` で実行されます。値: `P1-20260311`（ローポリ向けに最適化）、`P2-20260801`（次世代、クワッド出力に対応。プレビュー版）
enable_image_autofix	ブール値	オプション	偽	AI 補完と 3D 効果の向上に使用されます。低品質の入力画像を自動改善
texture_alignment	文字列	オプション	original_image	`original_image` または `geometry`
orientation	文字列	オプション	デフォルト	`default` または `align_image`
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 アンラップ制御
export_orientation	文字列	オプション	`+x`	輸出方向。使用可能な値: `-x`、`-y`、`+y`
quad	ブール値	オプション	false	`P2-20260801` のみ。三角面ではなくクワッドメッシュを出力します。出力形式は `FBX` に強制されます。`face_limit` 未指定時の既定値は 10,000 面です。

export_orientation に関する注意:

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

例

JSON

{
  "input": "https://example.com/image.png",
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true,
  "pbr": true
}

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

JSON

{
  "input": "https://example.com/image.png",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true,
  "pbr": true
}