Vai al contenuto

Tripo P2 Text to 3D

Integra

ID del modello tripo3d/p2/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/p2/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: 1,10 $ 1100 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#low-poly

Da testo a 3D con PBR, mesh quad, versione texture selezionabile e prompt negativo, variante P2 testuale

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.

Avanzate negative_prompt · texture_version · export_orientation · face_limit · image_seed · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
0 / 255

Descrizione delle caratteristiche da escludere dal modello generato.

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 durante la fase text-to-image interna.

Seed usato per rendere riproducibile la generazione della geometria.

Seed usato per rendere riproducibile la generazione delle texture.

POST /run/tripo3d/p2/text-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/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 P2 Text to 3D

Genera un modello 3D da un prompt fino a 1024 caratteri, con un `negative_prompt` fino a 255 caratteri. Le mesh supportano fino a 50,000 facce, o 25,000 quando `quad` è attivo. La qualità della texture varia da fast a extreme, con `texture_version` selezionabile, PBR opzionale, delighting ed esportazione UV. Sono disponibili seed per il passaggio immagine, la geometria e le texture.

Parametri

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
≤ 1024 caratteri
Descrizione testuale dell'oggetto 3D desiderato, limitata a 1024 caratteri.
negative_promptfacoltativo
Tipostring | null
≤ 255 caratteri
Descrizione delle caratteristiche da escludere dal modello generato.
image_seedfacoltativo
Tipointeger | null
Seed usato durante la fase text-to-image interna.
model_seedfacoltativo
Tipointeger | null
Seed usato per rendere riproducibile la generazione della geometria.
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.
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

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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/p2/text-to-3d.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt