Görüntüyü 3D Modele Dönüştürme — P Serisi

POST /v3/generation/image-to-model

P Serisi modelleri kullanarak bir görüntüden 3B model oluşturun. Temiz topolojiyle düşük poli üretim için optimize edilmiştir.

Standarttan Temel Farklılıklar

Low-poly çıktı için optimize edilmiştir (P1-20260311: 50–20.000 yüz; P2-20260801: 50.000’e kadar)
quad yalnızca P2-20260801 tarafından desteklenir; smart_low_poly, generate_parts ve geometry_quality desteklenmez

İstek Parametreleri

Parametre	Tür	Gerekli	Varsayılan	Açıklama
input	dize	Gerekli	-	Görüntü kaynağı. file_token, URL veya task_id’yi kabul eder
model	dize	Gerekli	-	P Serisi model sürümü. P Serisini çağırmak için belirtilmelidir; belirtilmezse istek varsayılan H Serisi modeli `v3.1-20260211` ile çalışır. Değerler: `P1-20260311` (low-poly için optimize), `P2-20260801` (yeni nesil, quad çıktı desteği; Önizleme)
enable_image_autofix	boolean	İsteğe bağlı	yanlış	Yapay zeka tamamlama ve 3D sonuç iyileştirme için kullanılır. Düşük kaliteli giriş görüntülerini otomatik olarak iyileştirin
texture_alignment	dize	İsteğe bağlı	original_image	`original_image` veya `geometry`
orientation	dize	İsteğe bağlı	varsayılan	`default` veya `align_image`
model_seed	tamsayı	İsteğe bağlı	rastgele	Geometri için rastgele tohum
face_limit	tamsayı	İsteğe bağlı	uyarlanabilir	Maksimum poligon sayısı. `P1-20260311`: 50–20.000; `P2-20260801` üçgen: 48–50.000, `quad=true` ile: 48–25.000
texture	boolean	İsteğe bağlı	doğru	Doku haritalarını etkinleştir
pbr	boolean	İsteğe bağlı	doğru	PBR’yi etkinleştirin. Dokuyu zorlar=doğru
texture_seed	tamsayı	İsteğe bağlı	rastgele	Doku için rastgele tohum
texture_quality	dize	İsteğe bağlı	standart	`fast` (`texture_version=v3.5-20260815` gerektirir), `standard`, `detailed` veya `extreme`
texture_version	dize	İsteğe bağlı	model’den türetilir	Doku modelini sabitler: `v3.5-20260815`, `v3.0-20250812` veya `v2.5-20250123`. P serisi geometri için varsayılan `v3.0-20250812`
delight	boolean	İsteğe bağlı	true	Dokulandırmadan önce referans görüntüdeki pişmiş aydınlatmayı kaldırır. Yalnızca `texture_version=v3.5-20260815` olduğunda dikkate alınır
auto_size	boolean	İsteğe bağlı	yanlış	Gerçek dünya boyutlarına ölçeklendirin
export_uv	boolean	İsteğe bağlı	doğru	UV paket açma kontrolü
export_orientation	dize	İsteğe bağlı	`+x`	İhracat yönlendirmesi. Mevcut değerler: `-x`, `-y`, `+y`
quad	boolean	İsteğe bağlı	false	Yalnızca `P2-20260801`. Üçgen yerine quad mesh üretir. Çıktı biçimini `FBX` olarak zorlar; `face_limit` verilmezse varsayılan 10.000 yüzdür.

export_orientation hakkında notlar:

Yalnızca bu üretim için geçerlidir. Model sonraki işleme görevlerinde (doku, rig, yeniden hedefleme, dönüştürme, …) kullanılacaksa bu parametreyi ayarlamamanız önerilir.
Ayarlandığında, sonraki işleme modelin yanlış yönü nedeniyle nihai sonucu etkileyebilir, ancak görev yine de status: success bildirir — hata oluşmaz. Dikkatli kullanın.
Modeli sonradan işlemeyi planlıyorsanız bu parametreyi boş bırakın ve son adımda /v3/models/convert aracılığıyla yönü dönüştürün.

Örnek

JSON

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

P2-20260801 ile quad çıktı:

JSON

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