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. Deve essere impostato per usare la serie P; se omesso, la richiesta viene eseguita con il modello predefinito della serie H, `v3.1-20260211`. 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	`fast` (richiede `texture_version=v3.5-20260815`), `standard`, `detailed` o `extreme`
texture_version	stringa	Facoltativo	Derivato da model	Fissa il modello di texture: `v3.5-20260815`, `v3.0-20250812` o `v2.5-20250123`. Per la geometria della serie P il valore predefinito è `v3.0-20250812`
delight	booleano	Facoltativo	true	Rimuove l’illuminazione incorporata dall’immagine di riferimento prima della texturizzazione. Considerato solo quando `texture_version=v3.5-20260815`
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
}