Multiview zum 3D-Modell – P-Serie

POST /v3/generation/multiview-to-model

Generieren Sie mit den Modellen der P-Serie ein 3D-Modell aus Multiview-Bildern. Optimiert für Low-Poly-Generierung mit sauberer Topologie.

Hauptunterschiede zum Standard

Optimiert für Low-Poly-Ausgabe (P1-20260311: 50–20.000 Flächen; P2-20260801: bis zu 50.000)
quad wird nur von P2-20260801 unterstützt; smart_low_poly, generate_parts und geometry_quality werden nicht unterstützt

Anforderungsparameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
inputs	string[]	Erforderlich	-	Liste mit 4 Multiview-Bildern [vorne, links, hinten, rechts]
original_task_id	Zeichenfolge	Optional	-	Aufgabe ID aus der vorherigen Multiview-Generation. Sich gegenseitig ausschließende Eingaben
model	Zeichenfolge	Erforderlich	-	Modellversion der P-Serie. Werte: `P1-20260311` (für Low-Poly optimiert), `P2-20260801` (nächste Generation, unterstützt Quad-Ausgabe; Preview)
texture_alignment	Zeichenfolge	Optional	original_image	`original_image` oder `geometry`
orientation	Zeichenfolge	Optional	Standard	`default` oder `align_image`
model_seed	ganze Zahl	Optional	random	Zufälliger Startwert für Geometrie
face_limit	ganze Zahl	Optional	adaptiv	Maximale Polygonanzahl. `P1-20260311`: 50–20.000; `P2-20260801` Dreiecke: 48–50.000, mit `quad=true`: 48–25.000
texture	Boolescher Wert	Optional	true	Aktivieren Sie Texturkarten
pbr	Boolescher Wert	Optional	true	Aktivieren Sie PBR. Forces texture=true
texture_seed	ganze Zahl	Optional	random	Random seed for texture
texture_quality	Zeichenfolge	Optional	Standard	`standard`, `detailed` oder `extreme`
auto_size	Boolescher Wert	Optional	falsch	Skalieren Sie auf reale Dimensionen
export_uv	Boolescher Wert	Optional	true	UV Auspacksteuerung
export_orientation	Zeichenfolge	Optional	`+x`	Exportausrichtung. Verfügbare Werte: `-x`, `-y`, `+y`
quad	Boolescher Wert	Optional	false	Nur `P2-20260801`. Gibt ein Quad-Mesh statt Dreiecken aus. Erzwingt das Ausgabeformat `FBX`; ohne `face_limit` werden standardmäßig 10.000 Flächen verwendet.

Hinweise zu export_orientation:

Gilt nur für diese Generierung. Wenn das Modell in Nachbearbeitungsaufgaben (Texturen, Rigging, Retargeting, Konvertierung, …) verwendet werden soll, wird empfohlen, diesen Parameter nicht zu setzen.
Wenn dieser Parameter gesetzt ist, kann die Nachbearbeitung aufgrund einer falschen Modellausrichtung das Endergebnis beeinträchtigen, während die Aufgabe weiterhin status: success meldet — es wird kein Fehler ausgelöst. Bitte mit Vorsicht verwenden.
Wenn Sie das Modell nachbearbeiten möchten, lassen Sie diesen Parameter leer und konvertieren Sie die Ausrichtung im letzten Schritt über /v3/models/convert.

Beispiel

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true
}

P2-20260801 mit Quad-Ausgabe:

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}