前言

今天在 SkillHub 技能社区看到一个叫 HY 3D Generation 的技能，刚好我当前的项目还差一个环节基本上就完成了闭环率.
当前这个项目之前想过直接调混元 3D 的 API，试了一圈发现参数和配置都整体来看还是有些复杂的,所以就一直搁浅了。如果这个技能生成效果够用的话,那么我想我的项目最后一块的拼图就完整了.
这篇文章记录的是我在 WorkBuddy 里试用 HY 3D Generation 的过程，先看看它能不能打，接入的事往后放。

HY 3D Generation 是什么

HY 3D Generation 提供的是混元生 3D 能力，底层基于腾讯混元大模型。它可以根据文本描述或者图片生成 3D 模型，支持多视角图片输入、PBR 材质、自定义面数，也能输出多种常见的 3D 文件格式。

我比较关注的不是它能不能单独生成一个模型，而是它能不能嵌到现有业务流里。对我的项目来说，只要能稳定接收提示词、生成模型文件、返回可用结果，后面的自动化流程就有机会接上。

项目当前的情况

先简单看一下我这个项目元境3D现在的状态。

首页主要展示一些热门模型，用户可以先浏览已有内容。

模型生成页负责收集用户的生成需求，比如模型风格、提示词等。

用户提交之后，相关内容会进入后台管理系统。

问题就在这里。现在后台能看到用户提交的需求，但模型生成这一步一直没有自动化。原本的方案是后台直接调用混元 3D API，接入时发现配置项比较多，任务创建、状态查询、文件处理这些环节也都要自己串起来，成本比想象中高。
所以这块一直是我项目里差“最后一公里”的地方，不是做不到，而是接入成本一直让我犹豫要不要现在就动手。
这次先不谈接入方案，单纯看 HY 3D Generation 能不能把一段提示词变成一个可用的模型文件，生成质量能不能打。如果这一步测下来靠谱，接入的事再说。

准备混元 3D 环境

使用这个技能之前，需要先准备腾讯云侧的配置。
先开通混元 3D 服务，入口在这里：开通混元 3D 服务。

然后去访问密钥页面获取 SecretId 和 SecretKey：获取 API 密钥。这里拿到的密钥要保存好，后面技能调用会用到。

在 WorkBuddy 中导入技能

回到 SkillHub，把 HY 3D Generation 下载到本地。

下载完成后，在 WorkBuddy 里选择“技能”，再选择“从本地添加技能”，把刚才下载的技能导入进来。

导入完成后，我先做了一次简单测试，确认 WorkBuddy 能正常识别并调用这个技能。

能正常响应之后，就可以继续配置环境变量了。

配置环境变量

官方推荐的方式是直接在系统环境变量里配置腾讯云密钥。

Linux / macOS 可以这样设置：

export TENCENTCLOUD_SECRET_ID="你的SecretId"
export TENCENTCLOUD_SECRET_KEY="你的SecretKey"

如果希望长期生效，可以写到 ~/.zshrc：

echo 'export TENCENTCLOUD_SECRET_ID="你的SecretId"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="你的SecretKey"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell 里可以这样配置：

$env:TENCENTCLOUD_SECRET_ID = "你的SecretId"
$env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey"

我这里没有直接手动改环境变量，而是让 WorkBuddy 结合技能帮我处理配置。输入内容大概是下面这样：

下面是 @skill:hy-3d-generation-1.0.0 技能所需要的 SecretId 和 SecretKey，接下来我要使用该技能帮我配置一下
SecretId:"你的SecretId"
SecretKey:"你的SecretKey"

执行过程如下图所示。

配置成功后，会看到类似下面的回复。

到这里，前置工作基本完成，可以开始生成模型了。

使用 Skill 生成模型

我直接从后台管理系统里挑了一个真实提示词来测试，这样更接近后续业务里的使用方式。

任务完成后，WorkBuddy 返回的信息比较完整，包含预览图、glb 文件和 obj 压缩包。

文件	大小	说明
sen_style_girl_preview.png	109 KB	512×512 预览图
sen_style_girl.glb	32 MB	标准 glTF 2.0 二进制文件，可直接导入 Blender、网页或游戏引擎
sen_style_girl_obj.zip	25 MB	OBJ、材质和贴图文件，兼容大多数建模软件

生成效果如下。

说实话效果比我预期要好一些。人物比例和风格跟提示词描述的基本一致，材质、贴图也是直接给好的，不用自己再调一遍。拖进 Blender 看了一下，面数控制得还算合理，没有那种一眼就能看出来是 AI 生成、拓扑乱成一团的问题。跟专业建模比细节上肯定还有差距，边缘部分偶尔会糊一点，但作为素材库里的一个候选模型，这个质量我是能接受的。

这次测试至少证明了一件事：提示词到可用模型文件这条链路是能跑通的，而且不用我自己再手写一遍混元 3D 的 API 调用逻辑。

后续想法

这次测试下来结论挺明确：生成质量够用，值得往下走一步。接下来我会认真考虑把 HY 3D Generation 接到后台管理系统里，让用户提交的模型需求能自动进入生成流程，而不是像现在这样卡在人工处理这一环。
具体接入的做法我大概想了一下：后台继续保留审核和状态管理，模型生成这一步交给技能来做，生成完的文件再回写到模型资源库。前台用户看到的还是完整的模型内容，后台不用再一件件手动跑生成任务。
不过这只是测试完之后的初步想法，真要接进项目还得再看任务失败率、并发量这些实际问题。这篇就先记录到测试这一步，接入的事等我真做了再写。