Vai al contenuto

Tripo3D · Image to 3D

Integra

ID del modello tripo3d/tripo/v2.5/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/tripo/v2.5/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 · 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 usata per generare il modello.

texture predefinito standard

Impostazione delle texture del modello: 'standard' è il valore predefinito, 'no' disabilita le texture e 'HD' produce texture ad alta definizione.

Impostazione dello stile; lasciala non specificata per mantenere l'aspetto e lo stile originali.

Avanzate texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment predefinito original_image

Impostazione della priorità di allineamento delle texture per un modello 3D, usando original_image salvo indicazione di un altro valore.

orientation predefinito default

Orientamento del modello, inizialmente impostato su `default`. Scegli `align_image` per ruotare automaticamente il modello e allinearlo all'immagine originale.

Limite massimo del numero di facce nell'output, scelto in modo adattivo salvo indicazione esplicita.

Seed intero che controlla la generazione della geometria; riutilizzarlo produce modelli identici. Se omesso, viene selezionato un valore casuale.

Seed per la generazione delle texture, fornito come intero o scelto casualmente se omesso. Valori di seed identici riproducono le texture; per modificare le texture di un modello, varia texture_seed mantenendo costante il seed del modello.

POST /run/tripo3d/tripo/v2.5/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/tripo/v2.5/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 Tripo3D · Image to 3D

Genera un modello 3D da una singola `image_url`. `texture` può essere no, standard o HD, con output PBR opzionale. Un preset `style` come clay, steampunk, gold o ancient bronze può modificare lo stile del risultato. Altri controlli includono `face_limit`, `quad` (forza FBX), `auto_size`, `texture_alignment` e `orientation` per allineare il modello all'immagine.

Parametri

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

NomeTipo PredefinitoConsentiti Descrizione
seedfacoltativo
Tipointeger | null
Seed intero che controlla la generazione della geometria; riutilizzarlo produce modelli identici. Se omesso, viene selezionato un valore casuale.
face_limitfacoltativo
Tipointeger | null
Limite massimo del numero di facce nell'output, scelto in modo adattivo salvo indicazione esplicita.
pbrfacoltativo
Tipoboolean | null
Predefinitofalse
Interruttore PBR: False produce un modello senza PBR, mentre True sovrascrive l'impostazione delle texture e la tratta come True. Il PBR è abilitato per impostazione predefinita.
texturefacoltativo
Tipoenum
Predefinitostandard
nostandardHD
Impostazione delle texture del modello: 'standard' è il valore predefinito, 'no' disabilita le texture e 'HD' produce texture ad alta definizione.
texture_seedfacoltativo
Tipointeger | null
Seed per la generazione delle texture, fornito come intero o scelto casualmente se omesso. Valori di seed identici riproducono le texture; per modificare le texture di un modello, varia texture_seed mantenendo costante il seed del modello.
auto_sizefacoltativo
Tipoboolean | null
Predefinitofalse
Interruttore per le dimensioni reali, disabilitato per impostazione predefinita (False), che regola automaticamente le dimensioni del modello usando i metri.
stylefacoltativo
Tipoenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Impostazione dello stile; lasciala non specificata per mantenere l'aspetto e lo stile originali.
quadfacoltativo
Tipoboolean | null
Predefinitofalse
La modalità quad forza l'output FBX quando è abilitata. Con quad=True e senza face_limit specificato, face_limit assume il valore predefinito 10000.
texture_alignmentfacoltativo
Tipoenum
Predefinitooriginal_image
original_imagegeometry
Impostazione della priorità di allineamento delle texture per un modello 3D, usando original_image salvo indicazione di un altro valore.
orientationfacoltativo
Tipoenum
Predefinitodefault
defaultalign_image
Orientamento del modello, inizialmente impostato su `default`. Scegli `align_image` per ruotare automaticamente il modello e allinearlo all'immagine originale.
image_urlobbligatorio image
Tipourl · image
URL dell'immagine usata per generare il modello.
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/tripo/v2.5/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": {
    "task_id": "string",
    "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
    },
    "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
    }
  },
  "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
task_id
stringIdentificatore dell'attività per la generazione del modello 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullOutput del modello.
base_model
object {url, content_type, file_name, file_size} | nullOutput del modello di base.
pbr_model
object {url, content_type, file_name, file_size} | nullOutput del modello PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullImmagine che mostra un'anteprima del 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/tripo/v2.5/image-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt