Tripo3D 模型,在 Blender 中精修
Tripo3D 能在大约一分钟内将一张图片或一个提示转化为带纹理的网格。 每次运行都会消耗积分,其控制比较粗糙,新的模型版本对相同的请求会生成不同的网格。 Blender 是免费且精确的,脚本能保证每次结果一致。因此,从 Tripo3D 获取一次基础网格并保留它,然后在 Blender 中进行所有细化调整。只有当形状错误时才需要为新的运行付费。尺寸、朝向、凹凸不平的手部、纹理色调和三角面预算都可以在 Blender 中修复。
于 2026-11-20 在 macOS 上使用 tripo-cli 0.11.2、Blender 5.3.0 和 Node 24 测试。如果 tripo --version 打印的是更新版本,请相信 tripo docs --topic commands/make 中的标志说明,而非此文件。
参考文件
此文件将一个模型从设置阶段带到完成的 GLB 文件。仅当任务需要其细节时才打开参考文件。
| 参考文件 | 在以下情况下打开 | 行数 |
|---|---|---|
| setup | 安装或登录、添加 MCP 服务器、在 Linux 上工作,或考虑使用其他 Tripo 路线时 | 146 |
| pictures | 为必须匹配目标图片的模型制作输入图片,并使其接受审查时 | 123 |
| generation | 选择模型或参数、使用多张图片、串联 Tripo 自身的步骤或计算积分时 | 146 |
| blender | 修复生成的模型、在实时 Blender 中工作,或将这些步骤集成到项目的构建中时 | 283 |
| errors | 读取失败命令的退出代码或 Blender 脚本错误时 | 43 |
此文件运行的两个脚本位于其旁边的 tools/ 目录。下文中的 <skill-dir> 指的是包含此 SKILL.md 的文件夹。
1. 人类必须先完成的事项
AI 代理无法完成这些操作。在运行任何命令之前,请先请求完成这些事项。
-
付费的 Tripo3D API 账户,位于 https://developers.tripo3d.ai(国际)或 https://developers.tripo3d.com(中国大陆)。API 积分与 Tripo Studio 积分是分开的。付费对于权利很重要:Tripo 的条款赋予付费用户对其输出的权利,包括发布和销售(第 5.2.2 节),而免费用户的输出则归 Tripo 所有(第 5.2.1 节)。
-
将 API 密钥存储在系统的密钥存储中。 在 macOS 上,人类运行以下命令并在提示符处输入密钥,这样密钥永远不会经过聊天传递:
security add-generic-password -a "$USER" -s tripo3d-api-key -w如果没有密钥,setup 中的浏览器登录方式也同样有效。
-
Blender 5.x,并且
blender命令在系统路径上。实时控制还需要安装 Blender Lab MCP 附加组件,并启用允许在线访问;请参见 blender。
切勿在聊天中索要密钥,也不要将其写入你创建的任何文件中。应像第 2 节那样内联地从密钥存储中读取密钥。
2. 设置 Tripo3D
每台机器执行一次:
node --version # 需要 20 或更高版本
npm install -g tripo-cli # 安装 `tripo` 命令
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor # 每个检查项都应为"ok": true
tripo login --key 会尝试两个区域,保留接受该密钥的区域,并将其保存到模式为 0600 的 ~/.tripo/config.json 文件中,因此后续命令无需再提供密钥。tripo doctor 输出中的零余额是警告,而非错误。
每次调用 Tripo 都使用其官方工具 tripo-cli。较旧的 Tripo-Developer/tripo-mcp 服务器启动时会崩溃,并且驱动着一个已不存在的 Blender 附加组件。Blender 中的 Tripo Bridge 附加组件仅能接收从 Tripo 网站发送过来的模型。setup 中有详细说明。
3. 生成基础模型
选择输入。 一张整个物体的、单独放置、背景简洁、正面或四分之三视角的图片。两到四张图片覆盖隐藏的侧面;将文件命名为 front、left、back 和 right。模型会复制图片中的形状、表面和颜色,因此磨损、苔藓和颜色必须出现在图片中。使用引号括起来的提示词也可以,但控制力较弱。
在付费前让图片接受审查。 图片中的缺陷会反映在网格中,而重新运行会再次消耗积分。当用户提供目标(例如概念艺术或照片)并要求模型与之匹配时:
- 仅根据目标编写一个检查清单:每个部分显示什么,哪些失败,以及可测量的比例和颜色;
- 为每个视角制作两到八个新候选图片,首先制作正面图,其他视角从已通过的正面图出发;
- 将目标、检查清单和候选图片交给一个独立的审查者——另一个代理或未制作这些图片的人——其职责是找出它们的缺陷;
- 仅对通过的图片运行 Tripo3D,并记下审查者允许通过的要点,以便在 Blender 精修阶段处理。
pictures 包含操作循环、如何向审查者简要说明、哪些图片不合格以及如何测量图片。
选择模型。 不指定 --model 时,每次运行默认使用 P2,其成本约为 H3.1 的三倍。
| 模型 | 标志 | 预估算积分 | 用途 |
|---|---|---|---|
| H3.1 | --model tripo-v3.1 | 10 到 50 积分;带详细 PBR 贴图的图片为 40 积分 | 详细的实体对象:雕像、道具、岩石 |
| P2(默认) | --model tripo-p2 | 100 到 130 积分;简单图片为 110 积分 | 干净的、四边形为主的低多边形拓扑 |
进行预运行。 预运行不发送任何内容,也不消耗任何积分:
tripo make ref.png --model tripo-v3.1 --seed 7 \
-p face_limit=30000 -p pbr=true -p texture_quality=detailed \
-p texture_version=v3.5-20260815 -p delight=true \
--name statue -o tripo-out/statue --dry-run --json
valid 必须为 true,errors 必须为空。warnings 中的每一项都是 CLI 已移除的设置,这意味着该要求将无法满足;在付费前先解决它。generation_credits_estimate 是该次生成本身的标价。
运行它(不带 --dry-run)。命令会阻塞,直到模型、preview.png 和 task.json 都出现在 -o 文件夹中,然后打印一行 JSON。从 model_file 字段中获取模型的路径,因为文件名会随选项变化(例如 pbr_model.glb)。在继续之前,先查看 preview.png。
保留原始结果。 下载链接大约五分钟后过期,并且后续的模型版本会根据相同的种子生成不同的网格,因此下载的文件是唯一的副本:
mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/ # 模型, task.json, preview.png
提交该文件夹,或将其与项目的源资产一起保留。每个 Blender 步骤都读取此副本,绝不访问网络,因此重建能得到相同的文件。
停下来询问用户:
- 在任何预估超过 50 积分的运行、任何 P2 运行,以及任何预估总计超过 150 积分的批次之前;
- 在遇到退出代码 4(积分不足)后,因为每次重试都会同样失败:告知用户执行
tripo topup并等待; - 在
tripo redo之前,因为这是一次新的付费运行,带有新的种子且没有预运行。
4. 在 Blender 中精修
两个脚本都无窗口运行,并且从不使用网络。
找出正面。 Tripo 的文档指出 +x 是生成模型的前向轴。Blender 的前视图沿 +y 轴观察,显示朝向 -y 的一面,因此将 +x 旋转到 -y 需要 --turn -90。并非所有网格都遵循默认方向,因此首先渲染原始模型并查看 front.png:
blender --background --factory-startup \
--python <skill-dir>/tools/preview_model.py -- \
assets/raw/statue/<model>.glb build/statue-raw --size 640
它会在大约两秒内输出 front.png、side.png 和 top.png。
完成精修:
blender --background --factory-startup \
--python <skill-dir>/tools/finish_model.py -- \
assets/raw/statue/<model>.glb build/statue.glb \
--height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024
此脚本会将所有变换烘焙到顶点中,将各部分合并为一个对象,并合并重复顶点。它会将模型绕垂直轴旋转 --turn 度,缩放到 --height 米,居中对齐,并将其最低点置于地面上。然后,它会缩小长宽超过 --texture 纹素的纹理,并输出 statue.glb,以及三角面数量缩减至 40% 和 12% 的 statue-1.glb 和 statue-2.glb。其最后一行 FINISHED {...} 给出了尺寸、缩小的纹理,以及每个文件的三角面和字节数。只有 --height 是必需的。--turn 默认为 0,不指定 --levels 或 --texture 时,不会生成副本并保留原始纹理。
以相同方式渲染完成的文件,再次查看。如果朝向错误,更改 --turn 并从原始文件重新精修。切勿旋转已导出的文件。
在付费进行新轮次前,先在 Blender 中修复。 缩放、朝向、枢轴、三角面数、纹理尺寸、颜色、小凸起和孔洞以及合并的部件都属于 Blender 的工作。只有当形状本身错误时才返回 Tripo3D。blender 中有对应表格。
使用实时 Blender 进行尝试性操作, 例如雕刻一只手或比较视图。每个最终确定下来的更改都应纳入脚本,以便从原始文件重建模型,因为手动编辑无法重复或审查,且下一次重新生成会丢失这些编辑。如果项目已经使用 Blender 脚本构建其模型,请将这些步骤添加到该构建中,而不是直接使用此脚本的输出。