Vai al contenuto

Tripo H3.1 Text to 3D

Integra

ID del modello tripo3d/h3.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 0,20 $ 200 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Tripo Da testo a 3D #3d#text-to-3d#3d-generation#tripo

Generatore di mesh 3D da testo con prompt negativo, livelli separati di qualità per geometria e texture e un limite molto elevato di facce

Tripo · 3D

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio 88 / 1024

Descrizione testuale dell'oggetto 3D desiderato, limitata a 1024 caratteri.

texture_quality predefinito standard

Impostazione della qualità delle texture; scegliere 'detailed' aumenta la risoluzione delle texture.

geometry_quality predefinito standard

Impostazione della qualità della geometria.

Avanzate negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Descrizione delle caratteristiche da escludere dal modello generato.

Target esplicito del numero di facce per la generazione della mesh, che sostituisce la selezione adattiva del modello quando fornito.

Seed usato per rendere riproducibile la generazione della geometria.

Seed usato durante la fase text-to-image.

Seed usato per rendere riproducibile la generazione delle texture.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 preventivo → 0,20 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Tripo H3.1 Text to 3D

Crea un modello 3D da una descrizione testuale fino a 1024 caratteri, con un `negative_prompt` opzionale per le caratteristiche da evitare. `face_limit` accetta da 1,000 a 2,000,000 facce. `geometry_quality` e `texture_quality` possono essere standard o dettagliate. Le opzioni includono materiali PBR, topologia quad, ridimensionamento automatico alle dimensioni reali e seed separati per geometria, passaggio da testo a immagine e texture.

Parametri

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
≤ 1024 caratteri
Descrizione testuale dell'oggetto 3D desiderato, limitata a 1024 caratteri.
negative_promptfacoltativo
Tipostring | null
≤ 1024 caratteri
Descrizione delle caratteristiche da escludere dal modello generato.
face_limitfacoltativo
Tipointeger | null
1000 – 2.000.000
Target esplicito del numero di facce per la generazione della mesh, che sostituisce la selezione adattiva del modello quando fornito.
texturefacoltativo
Tipoboolean
Predefinitotrue
Controlla se il modello riceve texture generate.
pbrfacoltativo
Tipoboolean
Predefinitotrue
Abilita i materiali PBR (Physically Based Rendering), attivando anche la generazione delle texture quando è true.
model_seedfacoltativo
Tipointeger | null
Seed usato per rendere riproducibile la generazione della geometria.
image_seedfacoltativo
Tipointeger | null
Seed usato durante la fase text-to-image.
texture_seedfacoltativo
Tipointeger | null
Seed usato per rendere riproducibile la generazione delle texture.
texture_qualityfacoltativo
Tipoenum
Predefinitostandard
standarddetailed
Impostazione della qualità delle texture; scegliere 'detailed' aumenta la risoluzione delle texture.
geometry_qualityfacoltativo
Tipoenum
Predefinitostandard
standarddetailed
Impostazione della qualità della geometria.
auto_sizefacoltativo
Tipoboolean
Predefinitofalse
Ridimensionamento automatico per assegnare al modello dimensioni reali misurate in metri.
quadfacoltativo
Tipoboolean
Predefinitofalse
Scegli tra facce triangolari e quadrangoli a 4 lati abilitando la topologia quad. Per i risultati quad, viene restituito un file FBX ogni volta che Tripo fornisce i dati come byte FBX.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
obbligatorio

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "base_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "pbr_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rendered_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
model_mesh
object {url, content_type, file_name, file_size}File GLB o FBX contenente il modello 3D generato, con il formato determinato da ciò che produce Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL che puntano a versioni alternative del modello 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullAnteprima renderizzata del modello 3D generato.
task_id
string | nullID riutilizzabile dell'attività Tripo che identifica il modello generato per rig o rig-check, consentendo queste operazioni senza caricare nuovamente il modello.

Altri modelli: Da testo a 3D

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/tripo3d/h3.1/text-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt