# 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"}'
```