# Modelli e Versioni
## Modelli di generazione 3D
Il parametro `model` utilizzato dagli endpoint di generazione 3D come `POST /v3/generation/text-to-model` e `POST /v3/generation/image-to-model`.
| Modello ID | Descrizione | Caso d'uso consigliato |
| :-: | :-: | :-: |
| `tripo-p1` | Le migliori prestazioni a basso numero di poligoni | Pipeline di gioco/gameplay generativo UGC/risorse 3D mobili |
| `tripo-v3.1` | Ultimo modello ad alta precisione (predefinito) | AAA condotte di produzione/stampa 3D e produzione flessibile |
| `tripo-v3.0` | Versione stabile della generazione precedente | Compatibilità con le versioni precedenti |
| `tripo-v2.5` | Versione precedente | Compatibilità storica del progetto |
## Modelli di generazione di immagini
Il parametro `model` utilizzato dagli endpoint `POST /v3/generation/text-to-image` e `POST /v3/generation/image-to-image`.
| Modello ID | Fornitore | Caratteristiche |
| :-: | :-: | :-: |
| `seedream_v4` | ByteDance | Modello predefinito con risultati equilibrati |
| `seedream_v5` | ByteDance | Ultima versione con qualità migliorata |
| `gemini-2.5-flash` | Google | Generazione veloce |
| `gemini-3-pro` | Google | Generazione di alta qualità |
| `gemini-3.1-flash` | Google | Ultima versione veloce |
| `chat_image_1` | ApriAI | GPT generazione di immagini |
| `chat_image_1.5` | ApriAI | GPT qualità superiore |
| `chat_image_2` | ApriAI | GPT più recente |
## Raccomandazioni per la selezione della versione
- **Nuovi progetti**: utilizza le versioni predefinite, `tripo-v3.1` per il 3D e `seedream_v4` per le immagini, per il miglior equilibrio tra qualità e stabilità
- **Ambienti di produzione**: aggiungi una versione del modello specifica per evitare incoerenze di output causate dagli aggiornamenti del modello
- **Massima qualità**: utilizza `tripo-p1` per il 3D e scegli `gemini-3-pro` o `seedream_v5` per le immagini a seconda dello scenario
- **Risorse di gioco/low-poly**: utilizza `tripo-p1` per il 3D: topologia più pulita e controllo del conteggio dei volti più preciso
## Richiedi esempi
```bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'
```
Modelli e Versioni
Modelli di generazione 3D
Il parametro model utilizzato dagli endpoint di generazione 3D come POST /v3/generation/text-to-model e POST /v3/generation/image-to-model.
Modello ID
Descrizione
Caso d’uso consigliato
tripo-p1
Le migliori prestazioni a basso numero di poligoni
Pipeline di gioco/gameplay generativo UGC/risorse 3D mobili
tripo-v3.1
Ultimo modello ad alta precisione (predefinito)
AAA condotte di produzione/stampa 3D e produzione flessibile
tripo-v3.0
Versione stabile della generazione precedente
Compatibilità con le versioni precedenti
tripo-v2.5
Versione precedente
Compatibilità storica del progetto
Modelli di generazione di immagini
Il parametro model utilizzato dagli endpoint POST /v3/generation/text-to-image e POST /v3/generation/image-to-image.
Modello ID
Fornitore
Caratteristiche
seedream_v4
ByteDance
Modello predefinito con risultati equilibrati
seedream_v5
ByteDance
Ultima versione con qualità migliorata
gemini-2.5-flash
Google
Generazione veloce
gemini-3-pro
Google
Generazione di alta qualità
gemini-3.1-flash
Google
Ultima versione veloce
chat_image_1
ApriAI
GPT generazione di immagini
chat_image_1.5
ApriAI
GPT qualità superiore
chat_image_2
ApriAI
GPT più recente
Raccomandazioni per la selezione della versione
Nuovi progetti: utilizza le versioni predefinite, tripo-v3.1 per il 3D e seedream_v4 per le immagini, per il miglior equilibrio tra qualità e stabilità
Ambienti di produzione: aggiungi una versione del modello specifica per evitare incoerenze di output causate dagli aggiornamenti del modello
Massima qualità: utilizza tripo-p1 per il 3D e scegli gemini-3-pro o seedream_v5 per le immagini a seconda dello scenario
Risorse di gioco/low-poly: utilizza tripo-p1 per il 3D: topologia più pulita e controllo del conteggio dei volti più preciso
Richiedi esempi
Bash
# Use the default model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot"}'
# Specify the flagship model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-model \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a robot", "model": "tripo-p1"}'
# Use an image generation model
curl -X POST https://openapi.tripo3d.com/v3/generation/text-to-image \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {api_key}" \
-d '{"prompt": "a futuristic city", "model": "seedream-v5"}'