# Modelos e Versões

## Modelos de geração 3D

O parâmetro `model` usado por terminais de geração 3D, como `POST /v3/generation/text-to-model` e `POST /v3/generation/image-to-model`.

| Modelo ID | Descrição | Caso de uso recomendado |
| :-: | :-: | :-: |
| `tripo-p1` | Melhor desempenho de baixo polígono | Pipelines de jogos / Jogabilidade generativa UGC / Recursos 3D móveis |
| `tripo-v3.1` | Modelo mais recente de alta precisão (padrão) | Pipelines de produção AAA/impressão 3D e fabricação flexível |
| `tripo-v3.0` | Versão estável da geração anterior | Compatibilidade com versões anteriores |
| `tripo-v2.5` | Versão legada | Compatibilidade histórica do projeto |

## Modelos de geração de imagens

O parâmetro `model` usado pelos terminais `POST /v3/generation/text-to-image` e `POST /v3/generation/image-to-image`.

| Modelo ID | Provedor | Características |
| :-: | :-: | :-: |
| `seedream_v4` | ByteDança | Modelo padrão com resultados equilibrados |
| `seedream_v5` | ByteDança | Versão mais recente com qualidade aprimorada |
| `gemini-2.5-flash` | Google | Geração rápida |
| `gemini-3-pro` | Google | Geração de alta qualidade |
| `gemini-3.1-flash` | Google | Última versão rápida |
| `chat_image_1` | AbrirAI | Geração de imagem GPT |
| `chat_image_1.5` | AbrirAI | GPT qualidade superior |
| `chat_image_2` | AbrirAI | GPT mais recente |

## Recomendações de seleção de versão

- **Novos projetos**: use as versões padrão, `tripo-v3.1` para 3D e `seedream_v4` para imagens, para obter o melhor equilíbrio entre qualidade e estabilidade
- **Ambientes de produção**: fixe uma versão de modelo específica para evitar inconsistências de saída causadas por atualizações de modelo
- **Mais alta qualidade**: use `tripo-p1` para 3D e escolha `gemini-3-pro` ou `seedream_v5` para imagens, dependendo do cenário
- **Ativos de jogo/low-poly**: use `tripo-p1` para 3D: topologia mais limpa e controle de contagem de rostos mais preciso

## Exemplos de solicitação

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