Testo in modello 3D - Serie P

POST /v3/generation/text-to-model

Genera un modello 3D da un messaggio di testo utilizzando i modelli della serie P. La serie P è ottimizzata per la migliore generazione di low-poly con topologia pulita e raffinata, ideale per risorse di gioco, contenuti stilizzati e flussi di lavoro 3D leggeri.

Differenze chiave rispetto allo standard

Ottimizzato per output low-poly (P1-20260311: 50–20.000 facce; P2-20260801: fino a 50.000)
~2s generazione di mesh con topologia strutturata
quad è supportato solo da P2-20260801; smart_low_poly, generate_parts e geometry_quality non sono supportati

Richiedi parametri

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
prompt	stringa	Obbligatorio	-	Richiesta di testo, fino a 1024 caratteri
negative_prompt	stringa	Facoltativo	-	Prompt negativo, fino a 255 caratteri
image_seed	intero	Facoltativo	casuale	Seme casuale per la fase da testo a immagine
model	stringa	Obbligatorio	-	Versione del modello serie P. Valori: `P1-20260311` (ottimizzato per low-poly), `P2-20260801` (nuova generazione, supporta l’output quad; Preview)
model_seed	intero	Facoltativo	casuale	Seme casuale per la generazione della geometria
face_limit	intero	Facoltativo	adattivo	Numero massimo di poligoni. `P1-20260311`: 50–20.000; `P2-20260801` triangoli: 48–50.000, con `quad=true`: 48–25.000
texture	booleano	Facoltativo	vero	Abilita mappe texture
pbr	booleano	Facoltativo	vero	Abilita mappe materiali PBR. Forza la texture=true
texture_seed	intero	Facoltativo	casuale	Seme casuale per la generazione di texture
texture_quality	stringa	Facoltativo	norma	`standard`, `detailed` o `extreme`
auto_size	booleano	Facoltativo	falso	Scala alle dimensioni del mondo reale (metri)
export_uv	booleano	Facoltativo	vero	UV scartare. false = file più veloce e più piccolo
export_orientation	stringa	Facoltativo	`+x`	Orientamento all’esportazione. Valori disponibili: `-x`, `-y`, `+y`
quad	booleano	Facoltativo	false	Solo `P2-20260801`. Produce una mesh quad invece di triangoli. Forza il formato di output a `FBX`; se `face_limit` non è impostato, il valore predefinito è 10.000 facce.

Note su export_orientation:

Si applica solo a questa generazione. Se il modello verrà utilizzato in attività di post-elaborazione (texture, rig, retarget, conversione, …), si consiglia di non impostare questo parametro.
Se impostato, la post-elaborazione può compromettere il risultato finale a causa di un orientamento errato del modello, pur riportando status: success — non viene sollevato alcun errore. Usare con cautela.
Se prevedi di post-elaborare il modello, lascia questo parametro non impostato e converti l’orientamento nell’ultimo passaggio tramite /v3/models/convert.

Esempio

JSON

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

P2-20260801 con output quad:

JSON

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

Risposta

JSON

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