Metni 3D Modele Dönüştürme — P Serisi

POST /v3/generation/text-to-model

P Serisi modelleri kullanarak bir metin isteminden 3B model oluşturun. P Serisi, temiz, iyileştirilmiş topolojiyle sınıfının en iyisi düşük poliüretim üretimi için optimize edilmiştir; oyun varlıkları, stilize içerik ve hafif 3D iş akışları için idealdir.

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)
Yapılandırılmış topolojiyle ~2s mesh oluşturma
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
prompt	dize	Gerekli	-	Metin istemi, en fazla 1024 karakter
negative_prompt	dize	İsteğe bağlı	-	Olumsuz bilgi istemi, en fazla 255 karakter
image_seed	tamsayı	İsteğe bağlı	rastgele	Metinden resme aşaması için rastgele tohum
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)
model_seed	tamsayı	İsteğe bağlı	rastgele	Geometri üretimi 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 malzeme eşlemelerini etkinleştirin. Dokuyu zorlar=doğru
texture_seed	tamsayı	İsteğe bağlı	rastgele	Doku üretimi 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 (metre) ölçeklendirin
export_uv	boolean	İsteğe bağlı	doğru	UV paketi açılıyor. false = daha hızlı, daha küçük dosya
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

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

P2-20260801 ile quad çıktı:

JSON

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

Yanıt

JSON

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