Tripo H3.1 API

Informazioni su Tripo H3.1

Forme 3D precise e colori fedeli da una foto prodotto.

Lo chiami con il nome di modello tripo/h3.1/image-to-3d su POST /jobs/createTask, da 0,432 USD.

Introduzione

Tripo H3.1 è il modello da immagine a 3D che Tripo AI ha presentato a marzo 2026 per asset di qualità da produzione, con geometria più nitida, migliore allineamento all'immagine di partenza e texture di qualità superiore ai modelli precedenti della serie H. Invii un'immagine (image_url) e ricevi un file glTF binario (.glb). A differenza dei convertitori a interruttore singolo, ogni fase della pipeline è esposta: texturizzare o meno la mesh, aggiungere mappe PBR, texture HD, geometria dettagliata, topologia a quadrilateri, un numero di facce di destinazione, la scala reale, l'orientamento finale e due seed separati. Non c'è un prompt.

Caratteristiche principali

Una forma che segue l'immagine

Nel nostro test con lo stivale, il modello ha mantenuto le proporzioni della foto e ha collocato l'anello del tallone, i ganci dei lacci e il battistrada sui lati giusti, anche se la foto mostrava solo il davanti. Il risultato texturizzato ha trasferito sulla mesh la pelle consumata, i lacci rossi e le cuciture.

Texture da attivare e migliorare

Le texture sono attive di default e arrivano come set PBR completo. Il nostro file con le impostazioni predefinite conteneva, in un unico materiale, una mappa del colore di base a 2048 pixel, una mappa metal-roughness e una mappa delle normali.

Topologia e dimensioni sotto controllo

face_limit limita il numero di facce tra 1.000 e 2.000.000, quad_mesh passa a poligoni a quattro lati per la modifica in uno strumento di modellazione, e geometry_quality: detailed dedica più calcolo ai dettagli fini della superficie. auto_size scala la mesh alle dimensioni reali e model_orientation: align_image la orienta in modo che corrisponda all'immagine.

Cosa abbiamo misurato

Con le impostazioni predefinite, una vista frontale di uno stivale di pelle (1024×1024) è tornata in 167 secondi come GLB da 45,8 MB con 1.471.382 triangoli e tre texture. Questa densità è il motivo per impostare face_limit per tutto ciò che viene mostrato in un browser.

Parametri della richiesta

Prezzi

I prezzi sono in USD. L’API usa un saldo separato in dollari statunitensi. I crediti del sito non si possono usare per l’API né convertire in saldo API; il saldo API non si può convertire in crediti del sito. Quando una richiesta viene accettata, riserviamo l’importo massimo del preventivo sul tuo saldo API. Al termine addebitiamo l’uso effettivo, senza superare la riserva, e liberiamo il resto. Se la richiesta fallisce, l’importo riservato viene sbloccato.

Prima di eseguire, invia lo stesso corpo della richiesta a POST /jobs/quote per vedere il costo stimato e quello massimo in USD. Il preventivo non esegue alcuna richiesta né addebita il saldo.

Casi d'uso

Asset per giochi, AR e scene in tempo reale

Imposta face_limit sul budget della tua scena, attiva quad_mesh se l'asset verrà modificato e tieni il PBR attivo perché il modello reagisca all'illuminazione della scena.

Visualizzazione di prodotto e stampa

Per un visualizzatore di prodotto, tieni le texture attive e usa texture_quality: detailed quando etichette o cuciture devono restare leggibili. Per la stampa 3D o la scultura, disattiva entrambi gli interruttori delle texture e imposta auto_size per ottenere una mesh in scala realistica.

Guida ai prompt e consigli da esperti

Parti da un'immagine pulita

Un solo soggetto, interamente nell'inquadratura, su sfondo uniforme. Una vista a tre quarti dà al modello più informazioni sulla profondità di una vista frontale diritta. JPEG, PNG o WebP fino a 10 MB.

Attiva solo ciò che ti serve

Fai una prima passata con i valori predefiniti e un face_limit, poi migliora solo la fase che non ha dato un buon risultato.

Itera con i due seed

seed fissa la geometria e texture_seed fissa la texture. Mantieni seed e cambia texture_seed per provare nuove superfici sulla stessa forma, oppure mantieni texture_seed mentre esplori le forme.

Controlla il lato nascosto

Apri il GLB in un visualizzatore e ruotalo completamente prima di usarlo. Se il lato non visibile è sbagliato, un'altra angolazione della camera nell'immagine di partenza aiuta più di qualsiasi impostazione.

Guida rapida all'API

Chiama l'API di Tripo H3.1 in tre passaggi

1. Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow-. Le chiamate usano il tuo saldo separato in dollari statunitensi.
2. Invia la richiesta. Invia POST /jobs/createTask con model tripo/h3.1/image-to-3d e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
3. Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.

Domande sull’API di Tripo H3.1

Altre API per immagini

• API di Seed3D 2.0Modelli 3D con texture ricche da un’immagine, ottimo per i personaggiA partire da 0,48 USD per generazione

Altro su Tripo H3.1

Provalo

Tripo H3.1: generatore di immagini IA onlineCrea immagini con Tripo H3.1 su PopNow

Documentazione

ID modello e schema di input di Tripo H3.1 nella documentazione APIGuida rapida all’API PopNow: invia la prima richiestaGuida alla generazione di immagini con l'API di PopNowWebhook: ricevi i risultati di Tripo H3.1 senza polling