Vai al contenuto

Tripo H3.1 Image to 3D

Integra

ID del modello tripo3d/h3.1/image-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

File come nell'esempio: 0,30 $ 300 crediti API · ≈ 32,27 ₽ i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Tripo Da immagine a 3D #3d#image-to-3d#3d-generation#tripo

Generazione 3D da una singola immagine con materiali PBR, mesh quad e controllo del numero 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 image_url
Trascina un file oppure

URL dell'immagine di input usata per creare un modello 3D.

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 texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment predefinito original_image

Riferimento per l'allineamento delle texture: usa 'geometry' per la geometria generata o 'original_image' per l'immagine di input.

orientation predefinito default

Orientamento del modello; 'align_image' lo ruota automaticamente per adattarlo all'immagine di input.

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 per rendere riproducibile la generazione delle texture.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 preventivo → 0,30 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 Image to 3D

Crea un modello 3D da un'immagine in `image_url`. Le opzioni includono `face_limit` (da 1,000 a 2,000,000), `texture`, `pbr`, `texture_quality` e `geometry_quality` standard o dettagliate, topologia `quad`, `auto_size` e `orientation`. Il risultato include un render di anteprima e un ID attività per il rigging successivo.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL dell'immagine di input usata per creare un modello 3D.
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.
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.
texture_alignmentfacoltativo
Tipoenum
Predefinitooriginal_image
original_imagegeometry
Riferimento per l'allineamento delle texture: usa 'geometry' per la geometria generata o 'original_image' per l'immagine di input.
auto_sizefacoltativo
Tipoboolean
Predefinitofalse
Ridimensionamento automatico per assegnare al modello dimensioni reali misurate in metri.
orientationfacoltativo
Tipoenum
Predefinitodefault
defaultalign_image
Orientamento del modello; 'align_image' lo ruota automaticamente per adattarlo all'immagine di input.
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 Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/image-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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 immagine a 3D

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