Vai al contenuto

Tripo P2 Image to 3D

Integra

ID del modello tripo3d/p2/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.com/v1/run/tripo3d/p2/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

File come nell'esempio: 1,10 $ 1100 crediti API 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#low-poly

Da immagine a 3D con PBR, topologia quad, quattro livelli di qualità della texture e selezione della versione texture

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.

Avanzate texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

Versione usata per la modellazione delle texture. Per la qualità fast, seleziona v3.5-20260815; le altre versioni non sono supportate per quella qualità.

export_orientation

Impostazione dell'asse anteriore per l'esportazione del modello, se specificata.

Limite superiore per le facce della mesh, con un limite separato di 25,000 per la topologia quad.

Seed usato per rendere riproducibile la generazione della geometria.

Seed usato per rendere riproducibile la generazione delle texture.

POST /run/tripo3d/p2/image-to-3d?wait=20 preventivo → 1,10 $
# 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/p2/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.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 P2 Image to 3D

Trasforma una singola immagine da `image_url` in un modello 3D con un massimo di 50,000 facce (25,000 per le mesh quad). La qualità della texture può essere fast, standard, dettagliata o extreme e `texture_version` seleziona il modello texture. Le altre opzioni riguardano mappe PBR, delighting, esportazione UV, dimensionamento automatico e asse forward dell'esportazione (`export_orientation`). Seed separati controllano geometria e texture.

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
48 – 50.000
Limite superiore per le facce della mesh, con un limite separato di 25,000 per la topologia quad.
texturefacoltativo
Tipoboolean
Predefinitotrue
Controlla se il modello riceve texture generate.
pbrfacoltativo
Tipoboolean
Predefinitotrue
Controlla la generazione delle mappe dei materiali PBR. L'attivazione del PBR abilita anche le texture.
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
faststandarddetailedextreme
Impostazione della qualità delle texture.
texture_versionfacoltativo
Tipoenum
v3.5-20260815v3.0-20250812v2.5-20250123
Versione usata per la modellazione delle texture. Per la qualità fast, seleziona v3.5-20260815; le altre versioni non sono supportate per quella qualità.
delightfacoltativo
Tipoboolean
Predefinitotrue
Rimozione dell'illuminazione incorporata prima della texturizzazione usando v3.5-20260815.
auto_sizefacoltativo
Tipoboolean
Predefinitofalse
Ridimensionamento automatico per assegnare al modello dimensioni reali misurate in metri.
export_uvfacoltativo
Tipoboolean
Predefinitotrue
Controlla se il modello riceve coordinate UV generate.
export_orientationfacoltativo
Tipoenum
+x-x-y+y
Impostazione dell'asse anteriore per l'esportazione del modello, se specificata.
quadfacoltativo
Tipoboolean
Predefinitofalse
Topologia della mesh con quadrangoli invece di triangoli.
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/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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.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 immagine a 3D

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