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