Tripo
Tripo H3.1
tripo-h3.1/text-to-3d
Modello di generazione 3D ad alto dettaglio di Tripo, supporta la generazione di asset 3D con texture da prompt testuali, da una singola immagine o da più viste; consente di regolare il numero di facce e la qualità delle texture e di esportare materiali PBR, ideale per la creazione di asset come oggetti di gioco e visualizzazione di prodotti
Prova tripo-h3.1/text-to-3d
Input
Output
Prezzi
tripo-h3.1/text-to-3d per model
+ $0.290 geometria più fine · se dettagliata è selezionato
Panoramica
Questo è un servizio di generazione da testo a modello 3D: gli sviluppatori devono solo inserire una descrizione in linguaggio naturale per ottenere asset di modelli 3D con texture. Il prompt supporta fino a 1024 caratteri, consente di escludere elementi indesiderati tramite un negative prompt e permette di impostare separatamente la qualità della geometria e delle texture, se produrre materiali PBR, il limite massimo di triangoli e più seed casuali per riprodurre i risultati. I risultati generati sono adatti a prototipi di giochi, visualizzazione di prodotti, design concettuale e altri scenari in cui è necessario trasformare rapidamente un'idea testuale in un modello 3D; il servizio è rivolto a sviluppatori di contenuti 3D, creatori indipendenti e team di design.
Caratteristiche principali
- Generazione diretta di asset 3D da testo: basta inserire una descrizione per ottenere un modello 3D con geometria e texture, eliminando il primo passaggio della modellazione manuale.
- Qualità di geometria e texture regolabili separatamente: la qualità della geometria e delle texture ha due livelli, standard e fine, per bilanciare dettaglio e scala di output in base all'uso.
- Supporto per materiali PBR e attivazione/disattivazione delle texture: per impostazione predefinita vengono generati materiali PBR e texture; è anche possibile disattivare contemporaneamente texture e PBR per mantenere solo una mesh puramente geometrica, adattandosi a diverse pipeline a valle.
- Parametri seed per riprodurre i risultati: l'immagine concettuale, la geometria e le texture dispongono ciascuna di un seed casuale, per ripetere o mettere a punto i risultati con le stesse impostazioni.
Descrizione delle capacità
Generazione di modelli 3D da descrizione testuale: costruisce la geometria 3D in base al prompt; il prompt supporta fino a 1024 caratteri ed è possibile aggiungere un negative prompt per escludere elementi indesiderati, ideale per creare asset concettuali da zero.
Controllo del numero target di triangoli: tramite il parametro del limite di facce è possibile specificare il numero target di triangoli, con valori da 1000 a 1,5 milioni (2 milioni con geometria fine); se non impostato, il modello decide in modo adattivo, per soddisfare le esigenze di rendering a valle.
Output di materiali PBR e texture: per impostazione predefinita vengono generati materiali PBR e texture; disattivando contemporaneamente texture e PBR viene prodotto un output di mesh puramente geometrica; la qualità delle texture può essere standard o fine, e il livello fine produce texture a risoluzione più elevata.
Finezza geometrica regolabile: la qualità geometrica può essere scelta tra standard e fine; il livello fine aggiunge dettagli di mesh più minuti, adatto ad asset che richiedono una presentazione in primo piano o un ulteriore affinamento.
Casi d'uso
- Produzione rapida di modelli di oggetti per prototipi di giochi: game designer o sviluppatori indipendenti descrivono a parole l'aspetto di un oggetto, generano un modello 3D con texture e lo importano nel motore per la validazione del prototipo e la costruzione dei livelli.
- Creazione di asset concettuali per la visualizzazione di prodotti: i team di design generano modelli 3D dalla descrizione del prodotto, per presentazioni preliminari, bozze visive di marketing e revisioni interne.
- Iterazione del design concettuale 3D: i concept designer generano varianti in batch con prompt e seed diversi, confrontano rapidamente le direzioni di forma e selezionano gli asset da passare alla fase di affinamento.
Limiti e consigli per la scelta
La lunghezza del prompt è limitata da 1 a 1024 caratteri; oltre tale limite non è possibile inviare la richiesta. Il limite di facce accetta solo numeri interi tra 1000 e 1,5 milioni (2 milioni con geometria fine); se non impostato, il modello decide autonomamente il numero di triangoli. La qualità delle texture e la qualità della geometria sono opzioni a scelta singola: ogni richiesta può selezionare solo uno dei due livelli. Con texture e PBR entrambi disattivati, il risultato è una mesh puramente geometrica, senza mappe di superficie. I parametri seed servono a migliorare la riproducibilità, ma lo stesso seed non garantisce risultati identici.
Novità
Vedi il changelog →- Nuovo modello tripo-h3.1/multiview-to-3d disponibile: generazione 3D multi-vista con Tripo H3.1
- Nuovo modello tripo-h3.1/text-to-3d disponibile: Tripo H3.1 text-to-3D
- Nuovo modello tripo-h3.1/image-to-3d disponibile: Tripo H3.1 da immagine a 3D
Domande frequenti
Vedi tutte le domande →-
Qual è il limite massimo di facce, può arrivare a 2 milioni?
Sì, il limite di face_limit è di 2 milioni di triangoli, ma il supporto effettivo fino a 2 milioni è garantito solo quando geometry_quality è impostato su detailed; con standard si consiglia di impostarlo entro 1,5 milioni. Se face_limit non viene passato, il numero di facce viene determinato adattivamente dal modello.
-
Come faccio se voglio solo una geometria senza texture?
Imposta sia texture che pbr su false; quando pbr è true, la generazione delle texture viene forzata. Se hai bisogno delle texture ma non dei materiali PBR, imposta texture su true e pbr su false.
-
È necessario attivare parametri separati per la geometria ad alta densità?
Impostare geometry_quality su detailed aggiunge dettagli di mesh più fini ed è anche il presupposto per poter raggiungere i 2 milioni di facce; se servono texture più dettagliate, impostare texture_quality su detailed. Entrambi sono predefiniti su standard; attivarli solo in base ai requisiti di primo piano dell'asset di destinazione.
-
Come si riproducono i risultati della generazione per confrontare parametri diversi?
Geometria e texture hanno seed fissi separati: model_seed controlla la geometria, texture_seed controlla le texture e la generazione 3D da testo ha in più image_seed che controlla l'immagine concettuale. Quando si confrontano parametri, occorre prima fissare i seed e modificare un solo parametro alla volta, così si può capire da quale elemento deriva la differenza.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: tripo-h3.1/text-to-3d
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per tripo-h3.1/text-to-3d e la route default — vedi la tabella dei parametri sotto.
pbrbooleanOpzionalePredefinito: trueIndica se generare materiali PBR; accetta un valore booleano, predefinito true; quando è true vengono emesse anche le texture.
promptstringObbligatoriominLength 1maxLength 1024Testo descrittivo dell'oggetto da generare, ad esempio una piccola teiera in ceramica, usato come prompt di input per la generazione 3D da testo.
texturebooleanOpzionalePredefinito: trueIndica se generare le texture per il modello, predefinito true. Nota: quando pbr è true le texture vengono generate forzatamente; solo impostando sia texture sia pbr a false viene prodotto un mesh puramente geometrico.
face_limitintegerOpzionalemin 1000max 2000000Numero target di triangoli, valore intero, intervallo 1000–1500000 (massimo 2000000 quando geometry_quality=detailed); se omesso, il numero di facce viene deciso adattivamente dal modello e il file risulta generalmente più grande; per la visualizzazione web si consiglia circa 50000.
image_seedintegerOpzionaleSeme casuale per la generazione dell'immagine concettuale, valore intero, utilizzato per riprodurre lo stesso risultato dell'immagine concettuale.
model_seedintegerOpzionaleSeme casuale riproducibile per la generazione della geometria, valore intero, utilizzato per riprodurre stabilmente lo stesso risultato geometrico.
texture_seedintegerOpzionaleSeme casuale riproducibile per la generazione delle texture, valore intero, utilizzato per riprodurre stabilmente lo stesso risultato di texture.
negative_promptstringOpzionalemaxLength 1024Prompt negativo, descrive i contenuti da evitare durante la generazione.
texture_qualitystringOpzionalePredefinito: "standard"Livello di qualità delle texture, valore stringa, predefinito standard; il livello detailed genera texture a risoluzione più elevata.
standarddetailedgeometry_qualitystringOpzionalePredefinito: "standard"Livello di qualità della geometria, valore stringa, predefinito standard; il livello detailed offre dettagli di mesh più fini.
standarddetailedcallbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/text-to-3d",
input: {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": True,
"prompt": "…",
"texture": True,
"texture_quality": "standard",
"geometry_quality": "standard"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Guida all'uso
Guida introduttiva a Tripo H3.1: come scegliere tra tre modalità di input, parametri e prezzi
Guida pratica per sviluppatori: decisioni di integrazione e controllo dei costi nella generazione 3D
-
Tutoriale
Scenari pratici di Tripo H3.1: 5 utilizzi ad alto valore e punti di implementazione
Da text-to-3D alla ricostruzione multi-view: scegliere modalità e parametri giusti per ogni scenario di business
-
Confronto e valutazione
Confronto orizzontale e guida alla scelta di Tripo H3.1: come scegliere e risparmiare tra tre percorsi di generazione 3D
Un compromesso tra prezzi e capacità pensato per gli sviluppatori, partendo dalla forma di input, dal dettaglio geometrico e dagli interruttori PBR/texture