Visualizzazione multipla su modello 3D - Serie P

POST /v3/generation/multiview-to-model

Genera un modello 3D da immagini multivista utilizzando i modelli della serie P. Ottimizzato per la generazione di pochi poligoni con topologia pulita.

Differenze chiave rispetto allo standard

Ottimizzato per output low-poly (P1-20260311: 50–20.000 facce; P2-20260801: fino a 50.000)
quad è supportato solo da P2-20260801; smart_low_poly, generate_parts e geometry_quality non sono supportati

Richiedi parametri

Parametro	Digitare	Obbligatorio	Predefinito	Descrizione
inputs	stringa[]	Obbligatorio	-	Elenco di 4 immagini multivisualizzazione [fronte, sinistra, retro, destra]
original_task_id	stringa	Facoltativo	-	Attività ID della precedente generazione multiview. Si escludono a vicenda con gli ingressi
model	stringa	Obbligatorio	-	Versione del modello serie P. Valori: `P1-20260311` (ottimizzato per low-poly), `P2-20260801` (nuova generazione, supporta l’output quad; Preview)
texture_alignment	stringa	Facoltativo	original_image	`original_image` o `geometry`
orientation	stringa	Facoltativo	predefinito	`default` o `align_image`
model_seed	intero	Facoltativo	casuale	Seme casuale per la 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 PBR. Forza la texture=true
texture_seed	intero	Facoltativo	casuale	Seme casuale per la consistenza
texture_quality	stringa	Facoltativo	norma	`standard`, `detailed` o `extreme`
auto_size	booleano	Facoltativo	falso	Scala alle dimensioni del mondo reale
export_uv	booleano	Facoltativo	vero	UV controllo scarto
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

{
  "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 con output quad:

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
}