Text zum 3D-Modell – P-Serie

POST /v3/generation/text-to-model

Generieren Sie mithilfe der Modelle der P-Serie ein 3D-Modell aus einer Texteingabeaufforderung. Die P-Serie ist für erstklassige Low-Poly-Generierung mit sauberer, verfeinerter Topologie optimiert – ideal für Spielressourcen, stilisierte Inhalte und schlanke 3D-Workflows.

Hauptunterschiede zum Standard

Optimiert für Low-Poly-Ausgabe (P1-20260311: 50–20.000 Flächen; P2-20260801: bis zu 50.000)
~2s Netzgenerierung mit strukturierter Topologie
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
prompt	Zeichenfolge	Erforderlich	-	Textaufforderung, bis zu 1024 Zeichen
negative_prompt	Zeichenfolge	Optional	-	Negative Aufforderung, bis zu 255 Zeichen
image_seed	ganze Zahl	Optional	random	Zufälliger Startwert für die Text-zu-Bild-Phase
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)
model_seed	ganze Zahl	Optional	random	Zufälliger Startwert für die Geometriegenerierung
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-Materialkarten. Erzwingt Textur=true
texture_seed	ganze Zahl	Optional	random	Zufälliger Startwert für die Texturgenerierung
texture_quality	Zeichenfolge	Optional	Standard	`standard`, `detailed` oder `extreme`
auto_size	Boolescher Wert	Optional	falsch	Skalierung auf reale Abmessungen (Meter)
export_uv	Boolescher Wert	Optional	true	UV Auspacken. false = schnellere, kleinere Datei
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

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

P2-20260801 mit Quad-Ausgabe:

JSON

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

Antwort

JSON

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