# Modèles et versions

## Modèles de génération 3D

Paramètre `model` utilisé par les points de terminaison de génération 3D tels que `POST /v3/generation/text-to-model` et `POST /v3/generation/image-to-model`.

| Modèle ID | Descriptif | Cas d'utilisation recommandé |
| :-: | :-: | :-: |
| `tripo-p1` | Meilleures performances low-poly | Pipelines de jeu / Gameplay génératif UGC / Ressources 3D mobiles |
| `tripo-v3.1` | Dernier modèle de haute précision (par défaut) | Pipelines de production AAA / Impression 3D et fabrication flexible |
| `tripo-v3.0` | Version stable de génération précédente | Compatibilité ascendante |
| `tripo-v2.5` | Version héritée | Compatibilité historique des projets |

## Modèles de génération d'images

Paramètre `model` utilisé par les points de terminaison `POST /v3/generation/text-to-image` et `POST /v3/generation/image-to-image`.

| Modèle ID | Fournisseur | Caractéristiques |
| :-: | :-: | :-: |
| `seedream_v4` | ByteDance | Modèle par défaut avec des résultats équilibrés |
| `seedream_v5` | ByteDance | Dernière version avec une qualité améliorée |
| `gemini-2.5-flash` | Google | Génération rapide |
| `gemini-3-pro` | Google | Génération de haute qualité |
| `gemini-3.1-flash` | Google | Dernière version rapide |
| `chat_image_1` | OuvertAI | Génération d'images GPT |
| `chat_image_1.5` | OuvertAI | GPT qualité supérieure |
| `chat_image_2` | OuvertAI | GPT dernier |

## Recommandations pour la sélection des versions

- **Nouveaux projets** : utilisez les versions par défaut, `tripo-v3.1` pour la 3D et `seedream_v4` pour les images, pour le meilleur équilibre entre qualité et stabilité.
- **Environnements de production** : épinglez une version de modèle spécifique pour éviter les incohérences de sortie causées par les mises à jour du modèle.
- **Qualité la plus élevée** : utilisez `tripo-p1` pour la 3D et choisissez `gemini-3-pro` ou `seedream_v5` pour les images en fonction du scénario.
- **Low-poly/ressources de jeu** : utilisez `tripo-p1` pour la 3D : topologie plus propre et contrôle du décompte des visages plus précis

## Exemples de demande

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