Tripo
gamedev pkg add aigd.tripo概览
通过你的 AI Game Dev 订阅额度使用云端 3D:从文本、单张图像或多视图生成 3D 模型,生成贴图、重拓扑、部件拆分、网格补全、格式转换、骨骼绑定、动画,以及图像生成与编辑。智能体会为每个任务挑选合适的操作和模型变体。
Tripo 通过 AI Game Dev 服务器,把 AI Game Dev 智能体连接到 Tripo 的云端 3D 与图像生成,费用从你的订阅额度中扣除。它能从文本、一张图像或多个视图生成 3D 模型,生成贴图,处理网格(重拓扑、拆分为部件、补全缺失的几何体、格式转换),为模型绑定骨骼并制作动画,还能生成和编辑图像。在当前应用版本中,智能体会为每个任务挑选操作和模型变体。桌面应用会自动安装它。它适合想要 3D 资产和动画、但没有本地 GPU 的开发者。
可以制作什么
- 根据文本提示、一张图像或多个视图,生成道具、角色、生物和场景的 3D 模型。
- 为已有的 3D 模型生成贴图。
- 更干净的网格:优化拓扑、把模型拆分为部件、补全缺失的几何体,或把文件转换为其他 3D 格式。
- 已绑定骨骼并带动画的角色:检查模型能否绑定骨骼、添加骨架、为其制作动画。
- 2D 图像:从文本生成、编辑,或作为同一对象的多视图(用于多视图转 3D)。
示例请求
- “用 Tripo 根据文本提示制作一个木质宝箱,并保存到项目中。”
- “把
Concepts/robot_front.png转成 3D 模型,然后绑定骨骼并添加走路动画。” - “为
Assets/Models/house.glb生成新的贴图。” - “把这个载具模型拆分为部件,并优化它的拓扑。”
- “为这张角色图创建正面、侧面和背面视图,然后用它们构建 3D 模型。”
亮点
| 类型 | 代码包(供智能体使用的会话工具)、云端生成 |
| 3D | 从文本、从图像、从多视图生成 3D |
| 贴图 | 为 3D 模型生成贴图 |
| 网格 | 优化拓扑、拆分为部件、补全缺失的几何体、转换文件格式 |
| 骨骼与动画 | 检查骨骼绑定、添加骨架、为已绑定骨骼的模型制作动画 |
| 2D | 从文本生成图像、编辑图像、创建和编辑多视图 |
| 费用 | 按订阅额度的百分比计费,并与对话的生成预算核对 |
| 安装方式 | 由桌面应用自动安装 |
| 许可 | Apache-2.0(本包) |
操作组
桌面应用会自动安装 aigd.tripo。它的五个操作组(3D、贴图、网格、骨骼与动画、2D)并不是各自独立的按钮:工具中对话的 3D 组会开启前四个,图像 会开启 2D。智能体可以使用其中哪些,仅在项目的模型界面中决定。
智能体会针对每个任务,从当前服务器目录中列为已启用、且符合用户套餐资格的所有变体中,挑选操作及其 variant_id;用户不自行选择。每次调用都会重新核对最新的目录,绝不会替换为其他模型。套餐不包含的变体不会出现在工具中;status 和 capability_search 会说明原因(PLAN_REQUIRED:需要更高档的套餐,只有用户自己可以购买)。工具无法更改会话设置。这需要宿主声明支持 env.features.agentChoosesVariants;在较旧的宿主上,本包保持原有行为(固定某个变体,或在各组设置中选择一份明确的“由智能体选择”允许列表)。较旧的 Kernel 只暴露设置和状态。
为任务付费
真实操作使用公开的 Kernel paidOperations API。Kernel 会获取不可变的服务器报价,将其与对话的生成预算核对(默认情况下,预算范围内的任务会直接运行,不再询问;在“每次操作前询问”模式下,由用户逐项批准),然后提交已批准的请求。预算无法覆盖的任务会被拒绝。会话配置不构成同意。密钥和账户令牌始终不进入本包;只有我们的服务器与 Tripo 通信。
等待、恢复与重试
正常生成会等待完成,并在同一次工具调用中保存所有产物。等待期间,该调用会保持应用的包重载和后台服务更新(aigd.work.hold),因此二者都不会在等待中途替换后端。智能体可以用 retrieve_result 恢复被中断的工作,或检查 jobs 和 recover_jobs 进行诊断,并撤销已保存的授权。下载重试绝不会重新生成资产。未知的提交结果会依据其持久化的请求标识进行恢复,而不会创建替代任务。已有文件会被保留。
账务
所有面向客户的估算和余额都以额度百分比表示。服务器账务按官方供应商成本扣费,不额外加价。实际执行取决于当前服务器就绪情况、订阅策略和 Kernel 支持。随附的设置页面不包含任何模拟控件。
验证
验证覆盖最新的策略变更、会话归属、提交前拒绝、无重试的确认丢失,以及不触发生成的产物获取。隔离的开发测试夹具属于 QA 辅助工具,并不构成对供应商的验证。
兼容性
兼容性:激活时会检查实际提议的 API,与引擎版本无关。此前负责会话配置的 Kernel 保留其旧版 webview 控件;当前 Kernel 会渲染全部五个已声明的模块,并管理它们的生命周期。缺少基线账户/会话配置 API 的 Kernel 不会注册任何提供程序,并记录一条需要更新应用的要求。此兼容路径绝不会替换变体,也不会授权支出。
已保存的资产
每个模块都在其清单中声明 context.assetOperations。只有当本次会话已产生输出文件时,Kernel 才会在该模块的设置中显示一个紧凑的资产计数。打开后会显示一个有尺寸限制的弹窗,绝不会是主动弹出的对话卡片。列表会排除其他模块和会话。已保存的文件会在项目查看器或文件管理器中打开;缺失或已更改的文件可以通过现有的持久投递日志恢复,而无需重复付费生成。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 0.2.20最新 | 0.25.11 或更高版本 | |
| 0.2.19 | 0.25.11 或更高版本 | |
| 0.2.18 | 0.25.11 或更高版本 | |
| 0.2.17 | 0.25.11 或更高版本 | |
| 0.2.16 | 0.25.11 或更高版本 | |
| 0.2.15 | 0.25.11 或更高版本 | |
| 0.2.14 | 0.25.11 或更高版本 | |
| 0.2.13 | 0.25.11 或更高版本 | |
| 0.2.8 | 0.25.10 或更高版本 | |
| 0.2.7 | 0.20.0 或更高版本 | |
| 0.2.6 | 0.20.0 或更高版本 | |
| 0.2.5 | 0.20.0 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.tripo,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.tripo环境要求
- AI Game Dev 0.25.11 或更高版本
gamedev pkg add aigd.tripo