Immagine nel modello 3D - Serie P

POST /v3/generation/image-to-model

Genera un modello 3D da un’immagine 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
input	stringa	Obbligatorio	-	Fonte dell’immagine. Accetta file_token, URL o task_id
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)
enable_image_autofix	booleano	Facoltativo	falso	Usato per il completamento AI e il miglioramento del risultato 3D. Migliora automaticamente le immagini di input di bassa qualità
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

{
  "input": "https://example.com/image.png",
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true,
  "pbr": true
}

P2-20260801 con output quad:

JSON

{
  "input": "https://example.com/image.png",
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true,
  "pbr": true
}