Agent Skills
返回列表
混元生3D

混元生3D

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_63d76e98/hunyuna。

技能介绍

要解决什么问题

做 3D 资产时，手工建模或扫描成本高；你需要的是把文本描述或参考图变成可下载的模型文件（如 obj、glb），并能在 Agent 对话里由脚本真实调用云端 API，而不是让模型「假装」给出链接。

技能如何工作

本技能封装腾讯云 混元生3D（tencentcloud.ai3d.v20250513），典型流程是：

  • 输入：Prompt 文生（≤1024 字）、ImageUrl / ImageBase64 图生，或 MultiViewImages 多视角（left/right/back 等）
  • 生成选项：GenerateType（Normal / LowPoly / Geometry / Sketch）、FaceCount（1 万～150 万）、EnablePBR、Model 3.0/3.1、ResultFormat（STL / USDZ / FBX 等）
  • 执行方式：默认跑 scripts/main.py 提交任务并轮询；也可 submit_job.py + query_job.py 分步。Agent 应在有生成意图时直接执行，失败则返回错误，禁止编造 URL

凭证从环境变量读取（需先在腾讯云开通 3D 视觉创作并配置 API 密钥）。

边界与注意点

  • 图生对分辨率与体积有限制（如 URL 图 ≤8MB）；3.1 不支持 LowPoly
  • 任务常需 1～5 分钟；ResultFile3Ds 中的下载 URL 仅 24 小时有效，需及时保存
  • 首次运行可自动装 SDK 依赖，但仍依赖有效密钥与网络可达 ai3d.tencentcloudapi.com

使用场景

  • 用中文文本描述角色或道具，调用混元 API 生成带纹理的 Normal 模型并拿到 obj/glb 下载链接
  • 只有一张产品或概念图 URL，需要图生 3D 并在 Agent 里自动提交、轮询直到 Status 为 DONE
  • 已拍摄 back、left_front 等多视角图，通过 MultiViewImages 合成模型并导出 FBX 或 STL 给下游管线
  • 需要 LowPoly 智能拓扑或 Sketch 草图风格，并指定 face-count 在 1 万～150 万之间控制模型体量

适合人员

  • 独立游戏或互动媒体作者，常用中文 prompt 试造型并要把云端结果保存为本地 glb/obj
  • 电商与品牌 3D 展示岗位，要把商品参考图转成可下载模型并注意 24 小时内抓取 URL
  • 产品或工业设计师，需要 Geometry 白模或固定面数模型做评审，而非手建初模
  • 在 Cursor 等环境里集成技能的工程师，要求 Agent 默认执行 main.py 且失败时返回真实错误信息