HY 3D Generation 体验记录：能否跑通 3D 模型生成流程

## 前言

今天在 [SkillHub](https://skillhub.cn) 技能社区看到一个叫 `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 服务](https://console.cloud.tencent.com/ai3d/start)。


然后去访问密钥页面获取 `SecretId` 和 `SecretKey`：[获取 API 密钥](https://console.cloud.tencent.com/cam/capi)。这里拿到的密钥要保存好，后面技能调用会用到。


在 WorkBuddy 中导入技能

回到 [SkillHub](https://skillhub.cn)，把 `HY 3D Generation` 下载到本地。


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


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


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

配置环境变量

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

Linux / macOS 可以这样设置：

```bash

export TENCENTCLOUD_SECRET_ID="你的SecretId"

export TENCENTCLOUD_SECRET_KEY="你的SecretKey"

```

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

```bash

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

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

source ~/.zshrc

```

Windows PowerShell 里可以这样配置：

```bash

$env:TENCENTCLOUD_SECRET_ID = "你的SecretId"

$env:TENCENTCLOUD_SECRET_KEY = "你的SecretKey"

```

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

```bash

下面是 @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` 接到后台管理系统里，让用户提交的模型需求能自动进入生成流程，而不是像现在这样卡在人工处理这一环。

具体接入的做法我大概想了一下：后台继续保留审核和状态管理，模型生成这一步交给技能来做，生成完的文件再回写到模型资源库。前台用户看到的还是完整的模型内容，后台不用再一件件手动跑生成任务。 不过这只是测试完之后的初步想法，真要接进项目还得再看任务失败率、并发量这些实际问题。这篇就先记录到测试这一步，接入的事等我真做了再写。","createTime":1786112531,"ext":{"closeTextLink":0,"comment_ban":0,"description":"","focusRead":0},"fa vNum":0,"html":"","isOriginal":0,"likeNum":0,