Tripo Texture

v3.5-20260815

Texturing PBR per modelli 3D esistenti.

Avvio rapido

Risoluzione massima

Livelli di qualità

fast / standard / detailed / 8K

Guida

Testo / immagine / 2–4 viste

Ingresso

GLB/GLTF/FBX/OBJ/STL

Uscita

Modello con texture PBR

Genera o rigenera texture PBR per un modello 3D esistente, fornito come task_id, file caricato o URL; il risultato può essere guidato da un testo, una singola immagine o più viste. Il modello di texture v3.5 aggiunge il controllo dell'illuminazione (delight), la modalità Veloce e un allineamento più preciso alla geometria, con risultati più coerenti tra le viste. La v3.5 va impostata esplicitamente, tramite model sull'endpoint di texture o texture_version sugli endpoint di generazione; in caso contrario viene usata la v3.0 predefinita. L'aggiornamento si applica solo alle nuove attività: i modelli e le texture esistenti restano invariati.

Controllo dell'illuminazione (delight, attivo per impostazione predefinita): da lasciare attivo per i giochi realistici — colore base pulito con l'illuminazione di Unity, Unreal o Godot; da disattivare per rendering, VFX e CG, così da preservare l'illuminazione stilizzata
Modalità Veloce: texture_quality=fast, stessi crediti di standard
Migliore allineamento alla geometria: i dettagli finiscono al posto giusto, con risultati più coerenti tra le viste
Guida tramite testo, riferimento di stile, immagine singola o 2–4 viste; supporto per PBR, rigenerazione delle texture per singole parti e 8K

Prezzi

Il prezzo dipende dal tipo di attività e da parametri specifici. La generazione di texture standard o l'utilizzo di opzioni di topologia premium comporta costi aggiuntivi.

Qualità	Crediti
Veloce (fast)	10
Standard (standard)	10
HD (detailed)	20
8K (extreme)	30

fast richiede il modello di texture v3.5-20260815; con qualsiasi altra versione di texture viene restituito l'errore 1004 invece di ripiegare su standard

Con il texturing all'interno di un'attività di generazione, l'output con texture costa 10 crediti in più rispetto alla sola geometria; HD ne aggiunge altri 10 e 8K altri 20

Endpoint

Fai clic su una delle schede endpoint seguenti per passare direttamente alla documentazione dettagliata di API e agli esempi di codice.

Texture

v3/models/texture

Testo in modello 3D

v3/generation/text-to-model

Immagine in modello 3D

v3/generation/image-to-model

Multivista in modello 3D

v3/generation/multiview-to-model

Parametri

model

Versione del modello di texture su /v3/models/texture: v3.0-20250812 (predefinita, per i modelli v3.0 / v3.1), v3.5-20260815 (la più recente; va impostata esplicitamente) o v2.5-20250123 (per i modelli v2.5)

texture_version

Versione del modello di texture sugli endpoint di generazione; stessi valori di model. Se omesso, segue il modello di geometria (v2.5 → v2.5, altrimenti v3.0)

texture_quality

fast (solo v3.5, stesse dimensioni e stessi crediti di standard), standard (predefinito), detailed (HD) o extreme (8K)

delight

Rimuove l'illuminazione incorporata dall'immagine di riferimento (impostazione predefinita: true). Da lasciare attivo per i giochi realistici e da disattivare per rendering / CG, così da preservare l'illuminazione stilizzata; solo v3.5, le versioni precedenti lo ignorano

texture_prompt

Guida per la texture: text (facoltativamente con style_image), image o images (vista frontale obbligatoria, almeno 2 viste; consigliati gli oggetti view-key, oppure 4 posizioni [frontale, sinistra, posteriore, destra] con null per le viste mancanti). text / image / images si escludono a vicenda

texture_alignment

original_image (predefinito, fedele ai colori dell'immagine di input) o geometry (fedele alla geometria generata)

texture_seed

Seme casuale; lo stesso seme riproduce la stessa texture

pbr

Genera materiali PBR (impostazione predefinita: true)

part_names

Nomi delle parti da un'attività di segmentazione della mesh; se omesso, la texture viene applicata a tutte le parti

bake

Esegue il bake degli effetti avanzati dei materiali nelle texture di base per una maggiore compatibilità (impostazione predefinita: true)

compress

geometry — compressione meshopt per un file più piccolo

Limiti di tariffa

I limiti di velocità garantiscono un accesso equo e affidabile allo API ponendo limiti specifici sulle richieste parallele. Il livello di utilizzo determina quanto sono alti questi limiti.

Categoria	Limite di concorrenza
Elaborazione del modello (condivisa con la conversione del formato)	5 attività in parallelo

Istantanee

Le istantanee ti consentono di bloccare una versione specifica del modello in modo che le prestazioni e il comportamento rimangano coerenti.

v3.5-20260815	La più recente: controllo dell'illuminazione e modalità Veloce; va impostata esplicitamente
v3.0-20250812	Predefinita; per i modelli generati con v3.0 / v3.1
v2.5-20250123	Per i modelli generati con v2.5