Models and Versions

3D Generation Models

The model parameter used by 3D generation endpoints such as POST /v3/generation/text-to-model and POST /v3/generation/image-to-model.

Model ID	Description	Recommended Use Case
`tripo-p1`	Best low-poly performance	Game pipelines / UGC generative gameplay / Mobile 3D assets
`tripo-v3.1`	Latest high-precision model (default)	AAA production pipelines / 3D printing & flexible manufacturing
`tripo-v3.0`	Previous-generation stable version	Backward compatibility
`tripo-v2.5`	Legacy version	Historical project compatibility

Image Generation Models

The model parameter used by POST /v3/generation/text-to-image and POST /v3/generation/image-to-image endpoints.

Model ID	Provider	Characteristics
`seedream_v4`	ByteDance	Default model with balanced results
`seedream_v5`	ByteDance	Latest version with improved quality
`gemini-2.5-flash`	Google	Fast generation
`gemini-3-pro`	Google	High-quality generation
`gemini-3.1-flash`	Google	Latest fast version
`chat_image_1`	OpenAI	GPT image generation
`chat_image_1.5`	OpenAI	GPT higher quality
`chat_image_2`	OpenAI	GPT latest

Version Selection Recommendations

New projects: Use the default versions, tripo-v3.1 for 3D and seedream_v4 for images, for the best balance of quality and stability
Production environments: Pin a specific model version to avoid output inconsistencies caused by model updates
Highest quality: Use tripo-p1 for 3D, and choose gemini-3-pro or seedream_v5 for images depending on the scenario
Low-poly / game assets: Use tripo-p1 for 3D — cleaner topology and more precise face-count control

Request Examples

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