使用指南
Tripo H3.1 上手指南:三种输入方式、参数与定价怎么选
面向开发者的 3D 生成接入决策与花费控制实操
本页内容
Tripo H3.1 能做什么,边界在哪
Tripo H3.1 是一个 3D 生成模型,接在 HiAPI.ai 的统一接口下,通过一个 API key 就能调用。它支持三种输入形态:自然语言描述(text-to-3d)、单张物体图片(image-to-3d)、以及同一物体 2–4 张多视图图片(multiview-to-3d)。
输出是固定的交付物组合:一个 GLB 模型文件 + 一张预览图。没有额外的材质贴图包、没有工程文件、没有骨骼绑定或动画。GLB 是通用格式,拿到后可以直接进 Blender、Three.js、Unity 或任意支持 glTF 的管线。
边界同样要讲清楚:
- 它是物件级生成,不是场景级生成。 输入一张椅子图,你会得到一把椅子,而不是一间摆着椅子的房间。需要场景请自行组合多个模型。
- 它不理解"动作"。 静态资产是它的舒适区;绑定、蒙皮、动作序列不在能力范围内。
- 素材质量即输出上限。 模糊、多物体、复杂遮挡的输入图会显著拉低几何质量,这一点在三条路径上都成立。
- 计费按次,一次调用产出一个模型,没有按 token 或按秒的中间态。这个特性对花费预估是好事——调用次数就是计费单位。
理解了这个范围,接下来的选择才有意义:三条路径不是同一个东西的三个入口,它们的单价、素材门槛和适用场景都不一样。

三条输入路径怎么选
选择路径的第一原则不是"哪个效果好",而是你手上有什么素材。
只有文字描述 → 文生 3D。 适合概念探索、占位资产、早期原型。你能完全控制生成方向,但也承担了全部不确定性:模型对面数与形态的推断完全来自你的描述词。起步价档位最低,适合大批量试错。
有一张干净的产品图或物体照 → 图生 3D。 这是绝大多数开发者实际会走的路径。一张正对物体的、背景干净的图,信息量远超一段文字描述,几何还原度明显更稳。素材门槛也不高:拍一张、抠一下背景即可。
有 2–4 张不同角度的图 → 多视图转 3D。 当你已经有多角度素材(比如产品摄影棚的标准四视图、或者从现有 3D 资产渲染出的转台帧),多视图是精度上限最高的一档。它解决了单图生成中"背面靠猜"的结构性问题。
值得注意的价格事实:图生与多视图同价,文生更便宜。所以在素材齐备的前提下,多视图没有额外溢价——有素材就用多视图,没有理由退回单图。
决策可以简化成一句:素材够多视图就用多视图,有一张好图就用图生,什么都没有才用文生。
输入参数与素材准备要点
三条路径的输入字段各不相同,混用会直接失败。
文生 3D(型号页)接收自然语言描述。写好 prompt 的要点是具体化:物体类型、材质倾向、形态特征,比堆砌形容词更有效。
图生 3D(型号页)使用 image_url,一张 HTTPS 图片。素材要求:
- 单个物体,不要多物体同框
- 背景干净,避免与主体同色的杂乱环境
- 物体主体尽量占满画面
- URL 必须可公开访问(HTTPS),不要传需要鉴权的私有地址
多视图转 3D(型号页)使用 image_urls,同一物体的 2–4 张图,顺序固定为前、左、后、右。顺序错乱是最常见的失败来源之一:模型会按位置假设视角,图放错位置等于给了它错误的几何约束。
素材准备上有两条通用建议。第一,多视图的几张图尽量保持一致的光照与尺度,混用不同来源的照片会让模型在拼接处产生歧义。第二,图片分辨率不必追求极大,清晰、主体明确比像素数更重要。
参数不合法(字段缺失、URL 格式错误、视图数量越界)的请求会被直接拒绝且不扣费——这一点在下一节的排错清单里还会用到。
face_limit 与几何质量:控制模型复杂度
face_limit 是控制输出面数的核心参数,取值范围 1000–1,500,000;当 geometry_quality 设为 detailed 时上限放宽到 2,000,000。
关键设计是:这个参数可以省略。 省略时由模型自适应决定面数,通常会给出一个与物体复杂度匹配的合理值。只有当你明确知道下游的面数预算时才需要手动指定:
- 移动端或 Web 实时渲染:偏低档,控制在几万面以内
- 游戏内中景资产:中等档位
- 影视级或离线渲染:靠近上限,配合精细几何
geometry_quality 有两个取值:standard(标准几何,默认)与 detailed(精细几何)。detailed 带来更高的几何细节和更高的面数上限,但是加收费用的选项,三条路径上都是如此。判断标准很直接:如果这个资产会被近距离观看、或者细节本身就是卖点,才值得开;作为远景或占位资产开 detailed 是纯浪费。
两者配合的实践建议:先用默认配置(省略 face_limit、geometry_quality 用 standard)跑一版看效果,再针对具体资产调参。不要一上手就顶满参数,那样既多花钱,又未必拿到更好的结果。
定价结构拆解:钱花在哪一档
Tripo H3.1 按次计费,每次调用产出模型 + 预览图。价格由四个变量共同决定:输入路径、Texture 开关、PBR 开关、几何质量。理解这个结构之后,再对照下面的完整挂牌价选档。
当前测试环境挂牌价如下,按次、每个模型计,单位 USD。
文生 3D(tripo-h3.1/text-to-3d)
| 规格 | 标准纹理 | 精细纹理 |
|---|---|---|
| PBR 关 · Texture 关 | $0.150 | $0.150 |
| PBR 关 · Texture 开 | $0.290 | $0.430 |
| PBR 开 | $0.290 | $0.430 |
图生 3D(tripo-h3.1/image-to-3d)与多视图转 3D(tripo-h3.1/multiview-to-3d)同价
| 规格 | 标准纹理 | 精细纹理 |
|---|---|---|
| PBR 关 · Texture 关 | $0.290 | $0.290 |
| PBR 关 · Texture 开 | $0.430 | $0.580 |
| PBR 开 | $0.430 | $0.580 |
以上各档在选择精细几何时,另加收 $0.290。
第一层:输入路径。 文生 3D 的起步档位最低;图生与多视图同价,且高于文生。这符合直觉:图生和多视图喂进去的信息更多,模型做的工作也更多。
第二层:Texture 与 PBR 开关,这是价格的主放大器。 两个开关都关闭时是基础档;开启 Texture 后单价上一个台阶;PBR 开启后落在同一档或更高档。换句话说,从"纯几何"到"带纹理带 PBR"的完整资产,单价可能翻倍以上。 这是全表最大的价格变量,远比输入路径的差异显著。
第三层:纹理精细度。 在纹理开启的前提下,标准纹理与精细纹理是两个价。精细纹理在文生路径上的溢价尤其明显。
第四层:几何质量。 选择 detailed 精细几何是在上述价格之上额外加收,且三条路径加收额度相同。
由此得到几条定价判断:
- 如果下游只需要几何体(比如做碰撞体、做后续手工贴图的底模),关掉 Texture 和 PBR,单价立刻回落到最低档。
- 如果只是做原型验证,用文生 + 全关开关是最省的组合。
- 真正昂贵的是"精细纹理 + PBR + 精细几何"三件套全开的完整交付,这应当是确认资产要上线之后才做的决定。

典型场景的推荐配置与花费估算
把结构落到具体组合上。以下方案都以单次调用为单位,实际花费按调用次数累加。
原型与概念探索
文生 3D,Texture 关、PBR 关,geometry_quality 用 standard,face_limit 省略。这是全模型的最低档位,适合一次生成十几个方向快速筛选。筛选通过后再对入围方案重跑一次带纹理的版本。
电商 / 产品展示资产
有产品图就走图生 3D;如果有标准四视图素材,走多视图。Texture 开、PBR 开(PBR 对材质质感的呈现有实际价值,展示场景值得花这笔钱),纹理选标准档,几何用 standard。如果商品会被特写观看,再考虑升精细纹理。
游戏 / 实时渲染资产
图生或多视图,Texture 开、PBR 视渲染管线而定(管线支持 PBR 就开)。face_limit 按目标平台手动设定,别交给自适应。几何质量默认 standard——实时渲染下 detailed 的收益通常体现不出来。
只做几何底模
任意路径,Texture 与 PBR 全关,几何质量按需要选。这是把花费压到结构最低的做法,后续贴图交给美术流程。
一个通用省钱的节奏:先用低价档位验证方向,再对确认的资产开高档位重跑。 不要对每一个试错都付全价。
接入排错与验证清单
接入期最重要的一条机制:参数不合法的请求会被直接拒绝,且不扣费。 这意味着你可以在开发阶段大胆试错——把字段名拼错、URL 格式不对、视图数量超范围,代价是报错而不是账单。利用好这个特性,先把参数校验跑通再谈效果。
上线前的验证清单:
- URL 可访问性:用匿名请求测一遍
image_url/image_urls,确认 HTTPS 且无需鉴权即可访问。本地能打开不代表公网能拉。 - 多视图顺序:逐张核对是否为前、左、后、右。这是最高频的静默错误——请求会成功,但结果变差,很难归因。
- 视图数量:多视图严格控制在 2–4 张。
face_limit边界:若手动指定,确认落在 1000–1,500,000 内;用detailed时上限才放宽到 2,000,000。越界会被拒。- 开关与预期一致性:检查 Texture / PBR 开关是否与你预期的价格档位匹配。默认配置与最终配置之间最容易出现"以为关了其实开着"的偏差。
- 产物验证:每次调用应拿到一个 GLB 与一张预览图。在接入层校验两者都存在,再进入下游。
- 失败重试策略:区分"参数被拒"(改参数,不要重试)与"网络/服务异常"(可重试),避免对必然失败的请求反复计费调用。
把这份清单过一遍,绝大多数接入期的问题都能在第一次上线前解决。
三种输入路径对应三种素材现状,两个开关决定价格量级,face_limit 只在你有明确预算时才需要碰。按这个顺序决策,Tripo H3.1 的接入会相当直接——从型号页开始跑第一次调用即可。