模型与版本

3D 生成模型

用于 POST /v3/generation/text-to-model 和 POST /v3/generation/image-to-model 等 3D 生成端点的 model 参数。

模型标识	说明	推荐场景
`v3.1-20260211`	H3.1，最新高精度模型版本（默认）	3A 作品制作管线 / 3D 打印柔性制造
`v3.0-20250812`	H3.0，上一代稳定版	兼容性需求
`v2.5-20250123`	H2.5，旧版	历史项目兼容
`P2-20260801`	P2 预览版，原生四边面拓扑；三角面 48–50,000、四边面 48–25,000	游戏角色与道具 / 硬表面资产 / 实时生产管线
`P1-20260311`	P1，低面数表现更好；面数 50–20,000	游戏管线制作 / UGC 生成式玩法 / 移动端设备 3D 资产生成

图像生成模型

用于 POST /v3/generation/text-to-image 和 POST /v3/generation/image-to-image 端点的 model 参数。

模型标识	特点
`seedream_v4`	文生图默认模型，效果均衡（图生图不支持）
`seedream_v5`	最新版，质量提升；图生图默认模型
`banana`	快速生成
`banana_pro`	高质量生成
`banana2`	最新快速版本
`chat_image_1`	基础图像模型（2026-10-23 下线）
`chat_image_1.5`	更高质量（2026-12-01 下线）
`chat_image_2`	质量最佳
`chat_image_2.5_flare`	2.5 速度档
`chat_image_2.5_sunburst`	2.5 精修档

版本选择建议

新项目：使用默认版本（3D 用 v3.1-20260211；图像方面文生图用 seedream_v4、图生图用 seedream_v5），享受最佳的质量与稳定性平衡
生产环境：锁定具体版本号，避免模型更新导致输出不一致
追求最高质量：3D 使用 v3.1-20260211（可配合 geometry_quality=detailed），图像根据场景选择 banana_pro 或 seedream_v5
低面数 / 游戏资产：3D 使用 P 系列，拓扑更干净，面数控制更精确：P2-20260801（预览版，支持原生四边面、面数上限更高）或 P1-20260311

请求示例

Bash

# 使用默认模型
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"}'

# 指定旗舰模型
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": "v3.1-20260211"}'

# 使用 P2 预览版生成四边面模型
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": "P2-20260801", "quad": true}'

# 使用图像生成模型
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"}'