H3.1 默认返回带 PBR 材质的 GLB。HD 与 8K 贴图、超精细几何、四边面网格、
智能低模和部件拆分均需手动开启,每一项都会增加费用。
端点
异步 —— 返回 {id, status: "pending"};轮询
GET /v1/3d/generations/{id} 直到 success 或 failed。大多数生成
会在 1–3 分钟内完成。幂等性、回调与错误见 3D 生成参考。
参数
为模型生成贴图。将它与 pbr 都设为 false 可得到无贴图的白模,计费更低。
生成基于物理的(PBR)材质。pbr: true 会同时开启贴图,因此无贴图白模需要
把 texture 和 pbr 都设为 false。
"fast" | "standard" | "detailed" | "extreme"
默认值:"\"standard\""
detailed 为 HD 贴图,extreme 为 8K 贴图。仅在生成贴图时生效;
detailed 与 extreme 会增加费用。
fast 以贴图细节换取速度,按标准价计费;它运行在贴图模型
v3.5-20260815 上,会自动使用。
"standard" | "detailed"
默认值:"\"standard\""
detailed 为超精细几何模式,表面细节更密、更精细。会增加费用。
输出四边面网格而非三角面。此时模型文件为 .fbx 而不是 .glb。会增加费用。
生成拓扑干净、接近手工布线的低模网格。形状越简单效果越好。会增加费用。
将模型拆分为可单独编辑的部件。需要同时设置 texture: false 与
pbr: false。会增加费用。
输出网格的最大面数,范围 500 到 2,000,000。不传则由模型根据物体自动选择
合适的面数。
几何随机种子,0 到 2147483647。相同输入配合相同种子可复现同一网格。
贴图随机种子,0 到 2147483647。固定 model_seed 后改变它,可在同一
几何上得到不同贴图。
提示词处理阶段的随机种子,0 到 2147483647。与 model_seed、
texture_seed 一起固定,可复现文生 3D 的结果。
"v3.5-20260815" | "v3.0-20250812"
独立于几何模型指定贴图模型。不传时使用默认值(v3.0-20250812;
texture_quality: "fast" 时为 v3.5-20260815)。
贴图前去除参考图中烘焙的光照。仅贴图模型 v3.5-20260815 读取此项。
生成时展开 UV。设为 false 生成更快、文件更小。
"+x" | "-x" | "-y" | "+y"
默认值:"\"+x\""
导出模型的前向轴。
输出
success 时,data 按固定顺序包含生成的文件:
data[0].url —— 3D 模型:内嵌材质的二进制 glTF(.glb)文件;quad: true 时为 .fbx。
data[1].url —— 模型的 PNG 渲染预览图(Tripo 返回时提供)。
两个文件都托管在 VibeToken 媒体 CDN 上,每个 URL 都以文件的真实扩展名结尾,可据此选择
加载器。需要长期保留的文件请自行下载保存。
示例
轮询直到终态:
编写提示词
- 描述单个物体而不是场景:形状、材质、颜色和风格,例如「一把竹柄陶瓷茶壶,哑光蓝釉」。
- 不想要的内容(底座、文字、多余部件)写进
negative_prompt,而不是写进提示词。
- 迭代时固定
model_seed、改变 texture_seed(或反过来),让几何与贴图分别变化。
定价
按次计费;开启的选项会改变价格,失败的生成不收费。影响价格的因素见
Tripo H3.1 快速入门,当前费率见定价页。