文档 /
节点说明 /
Tripo: 绑定模型
Tripo: 绑定模型
此节点接收一个现有的 Tripo 3D 模型,并为其创建绑定骨骼后的版本,也就是说,模型会获得一副骨架,从而可以制作动画。
节点说明
TripoRigNode 更新于 2026-11-12
Tripo: 绑定模型 - ComfyUI Built-in Node Documentation
此节点接收一个现有的 Tripo 3D 模型,并为其创建绑定骨骼后的版本,也就是说,模型会获得一副骨架,从而可以制作动画。
此节点接收一个现有的 Tripo 3D 模型,并为其创建绑定骨骼后的版本,也就是说,模型会获得一副骨架,从而可以制作动画。你需要提供要绑定的模型的任务 ID,选择绑定版本、骨架类型、骨骼命名风格和输出文件格式,节点会将任务发送给 Tripo,等待其完成,然后返回下载的结果。
输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
原始模型任务ID | 要绑定的原始 3D 模型的任务 ID。这通常是之前的 Tripo 模型生成节点产生的 ID。 | MODEL\_TASK\_ID | 是 | - |
model_version | 要使用的绑定模型版本。v1.0:仅支持人形(biped)角色,90+ 动画预设。v2.5:非人形生物(quadruped、hexapod、octopod、avian、serpentine、aquatic)。默认:v1.0-20240301。 | COMBO | 否 | "v1.0-20240301" "v2.5-20260210" |
rig_type | 骨架类型。"auto" 会先运行 Tripo 的免费绑定检查,并使用推荐类型。默认:"auto"。 | COMBO | 否 | "auto" "biped" "quadruped" "hexapod" "octopod" "avian" "serpentine" "aquatic" |
spec | 骨骼命名:Tripo 原生或兼容 Mixamo。Tripo 无法将其动画预设重定向到使用 mixamo 规范制作的 v1.0 骨骼上;若要用于 Tripo: Retarget rigged model,请使用 tripo。默认:"tripo"。 | COMBO | 否 | "tripo" "mixamo" |
out_format | 输出文件格式;结果会出现在匹配的输出上。默认:"glb"。 | COMBO | 否 | "glb" "fbx" |
注意: v1.0 模型版本(v1.0-20240301)仅支持 biped 骨架。如果此版本与非 biped 的 rig_type 一起使用,节点会抛出错误,并提示你改用 v2.5-20260210。
注意: 当 rig_type 为 "auto" 时,Tripo 首先检查模型能否绑定骨骼,并选择推荐的骨架类型。如果 Tripo 报告模型无法绑定骨骼,节点会失败并报错。
注意: 该节点期望 Tripo 返回 GLB 或 FBX 文件。如果 Tripo 返回任何其他文件类型,节点会抛出错误。
注意: 只有与 out_format 匹配的输出会被填充:当 out_format 为 "glb" 时填充 GLB,当 out_format 为 "fbx" 时填充 FBX。另一个 3D 输出为空。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
model_file | 生成的绑定骨骼模型文件名(任务 ID 加格式扩展名)。仅为向后兼容保留。 | STRING |
rig task_id | 用于跟踪绑定生成过程的任务 ID。 | RIG\_TASK\_ID |
GLB | 绑定骨骼后的模型,格式为 GLB 3D 文件。当 out_format 为 "glb" 时填充。 | FILE3DGLB |
FBX | 绑定骨骼后的模型,格式为 FBX 3D 文件。当 out_format 为 "fbx" 时填充。 | FILE3DFBX |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): b9c1b6d27b6278bcee4fc22e11c11e65cd22ea92cab3fc6c74f84d3deb2024d6