模型能力
Tripo Texture
v3.5-20260815
为已有 3D 模型生成 PBR 贴图。
最高精度
8K
质量档
4 档
极速 / 标准 / 高清 / 8K
引导方式
文本 / 图片 / 2–4 视角
输入
GLB/GLTF/FBX/OBJ/STL
输出
PBR 贴图模型
为已有 3D 模型生成或重绘 PBR 贴图：模型可以用 task_id、上传文件或 URL 传入，并用文本、单张图片或多视角图片引导结果。贴图 V3.5 新增去光处理（delight）与极速模式，几何对齐更贴合模型，多视角之间的一致性也更好。V3.5 需显式指定：单独调用贴图接口用 model 参数，生成接口用 texture_version；不指定时仍使用默认的 v3.0。新版本只对新任务生效，已生成的模型和贴图不受影响。
- 去光处理（delight，默认开启）：写实游戏保持开启，得到干净的基础色，在 Unity、Unreal、Godot 的动态光照下表现自然；渲染 / 特效 / CG 场景关闭，保留风格化光照
- 极速模式：texture_quality=fast，积分与标准档相同
- 几何对齐更好：细节落在该在的位置，多视角一致性更强
- 支持文本、风格参考图、单图或 2–4 个视角引导；支持 PBR、按部件重新贴图与 8K
定价
定价基于任务类型和具体参数。生成标准贴图或使用高级拓扑选项会产生额外费用。
| 质量档 | 积分 |
|---|---|
| 极速（fast） | 10 |
| 标准（standard） | 10 |
| 高清（detailed） | 20 |
| 8K（extreme） | 30 |
极速档仅支持贴图版本 v3.5-20260815，其他版本传 fast 会返回错误码 1004，不会静默回退到标准档
在生成任务中直接出贴图时，带贴图比仅几何多 10 积分，高清另加 10，8K 另加 20
API 端点
参数
model
/v3/models/texture 的贴图版本：v3.0-20250812（默认，适用于 v3.0 / v3.1 模型）、v3.5-20260815（最新，需显式指定）或 v2.5-20250123（适用于 v2.5 模型）
texture_version
生成接口的贴图版本，取值与 model 相同；不传时跟随几何体版本（v2.5 → v2.5，其余 → v3.0）
texture_quality
fast（仅 v3.5，尺寸与积分同标准档）、standard（默认）、detailed（高清）或 extreme（8K）
delight
去除参考图中烘焙的光照（默认：true）。写实游戏保持开启，渲染 / CG 关闭以保留风格化光照；仅 v3.5 支持，更早版本忽略
texture_prompt
贴图引导：text（可搭配 style_image）、image，或 images（正面必填、至少 2 个视角；推荐 view-key 对象写法，也可按 [正面, 左侧, 背面, 右侧] 4 个位置传，缺失视角填 null）。text / image / images 三者互斥
texture_alignment
original_image（默认，优先匹配输入图颜色）或 geometry（优先匹配生成的几何体）
texture_seed
随机种子；相同种子生成相同贴图
pbr
生成 PBR 材质（默认：true）
part_names
来自网格分割任务的部件名称；不填则对所有部件贴图
bake
将高级材质效果烘焙到基础贴图以提高兼容性（默认：true）
compress
geometry：meshopt 压缩，减小文件体积
速率限制
速率限制通过对并行请求设置上限来确保 API 的公平和可靠访问。你的用量层级决定了这些限制的高低。
| 类目 | 并发限制 |
|---|---|
| 模型后处理（与格式转换共享） | 5 个并行任务 |
版本快照
版本快照让你锁定模型的特定版本，确保性能和行为保持一致。
| v3.5-20260815 | 最新：支持去光处理与极速模式，需显式指定 |
| v3.0-20250812 | 默认；适用于 v3.0 / v3.1 生成的模型 |
| v2.5-20250123 | 适用于 v2.5 生成的模型 |