Community图像github.com

tripo3d-blender

图片技能。使用 Tripo3D 创建 3D 模型,并在 Blender 中精修。Tripo3D 根据提示或图片生成基础网格,所有精细调整都在 Blender 中完成(无论是无头模式还是实时模式),包括尺寸、朝向、枢轴、清理、雕刻修复、重新上色、纹理尺寸、细节层次和 GLB 导出。当被要求从文本或图片生成或制作 3D 模型、雕像、道具、建筑、岩石、角色或游戏资产时使用,或当模型需要匹配概念艺术或照片时使用,包括制作和审查输入图片。

tripo3d-blender 是什么?

此技能提供了一个由 AI 驱动的工作流程,用于使用 Tripo3D 和 Blender 创建 3D 模型。它利用 Tripo3D 从文本提示或输入图片快速生成基础纹理网格,然后利用 Blender 强大的、可重复的脚本功能进行所有后续的细化、修复和导出。这种方法至关重要,因为它将一次性支付的 Tripo3D 生成费用与免费的、可精确控制的 Blender 编辑分离开来,确保一致的结果,而无需为每个小的调整花费积分。该技能支持 H3.1 和 P2 Tripo3D 模型,可处理无头和实时 Blender 操作,并提供参考文件,涵盖设置、图片创建、生成参数、Blender 修复和错误处理。它通过清单指导 AI 代理和人类协作者进行结构化审查,并在花费积分之前要求人类批准高成本的运行,这对于雕像、道具、建筑、岩石和游戏资产等任务至关重要。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hiddentao/tripo3d-blender-skill/tree/HEAD/tripo3d-blender

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 代理无法完成这些操作。在运行任何命令之前,请先请求完成这些事项。

  1. 付费的 Tripo3D API 账户,位于 https://developers.tripo3d.ai(国际)或 https://developers.tripo3d.com(中国大陆)。API 积分与 Tripo Studio 积分是分开的。付费对于权利很重要:Tripo 的条款赋予付费用户对其输出的权利,包括发布和销售(第 5.2.2 节),而免费用户的输出则归 Tripo 所有(第 5.2.1 节)。

  2. 将 API 密钥存储在系统的密钥存储中。 在 macOS 上,人类运行以下命令并在提示符处输入密钥,这样密钥永远不会经过聊天传递:

    security add-generic-password -a "$USER" -s tripo3d-api-key -w
    

    如果没有密钥,setup 中的浏览器登录方式也同样有效。

  3. 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。模型会复制图片中的形状、表面和颜色,因此磨损、苔藓和颜色必须出现在图片中。使用引号括起来的提示词也可以,但控制力较弱。

在付费前让图片接受审查。 图片中的缺陷会反映在网格中,而重新运行会再次消耗积分。当用户提供目标(例如概念艺术或照片)并要求模型与之匹配时:

  1. 仅根据目标编写一个检查清单:每个部分显示什么,哪些失败,以及可测量的比例和颜色;
  2. 为每个视角制作两到八个新候选图片,首先制作正面图,其他视角从已通过的正面图出发;
  3. 将目标、检查清单和候选图片交给一个独立的审查者——另一个代理或未制作这些图片的人——其职责是找出它们的缺陷;
  4. 仅对通过的图片运行 Tripo3D,并记下审查者允许通过的要点,以便在 Blender 精修阶段处理。

pictures 包含操作循环、如何向审查者简要说明、哪些图片不合格以及如何测量图片。

选择模型。 不指定 --model 时,每次运行默认使用 P2,其成本约为 H3.1 的三倍。

模型标志预估算积分用途
H3.1--model tripo-v3.110 到 50 积分;带详细 PBR 贴图的图片为 40 积分详细的实体对象:雕像、道具、岩石
P2(默认)--model tripo-p2100 到 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 脚本构建其模型,请将这些步骤添加到该构建中,而不是直接使用此脚本的输出。

相关技能