前言¶
做内容、做界面或做原型时，配图往往卡在「找图」和「改图」上：关键词搜到的素材不对题，自己画又慢。把文生图、图生图接到对话式 Agent 里，可以用自然语言描述需求，由 Skill 走统一流程去调云侧能力，而不是每次手写 SDK 或翻控制台文档。
下面介绍 SkillHub 上的 HY Image Generation（@tencent-adm/hy-image-generation），它把腾讯云混元生图 3.0 封装成 Agent Skill，面向「描述生成图片」和「参考图再生成」两类任务。
这是什么¶
HY Image Generation 是腾讯云智能创作团队在 SkillHub 发布的企业来源 Skill（分类 design-media），当前版本 v1.0.2。一句话定位：基于腾讯云混元生图 3.0，支持文生图与图生图，按文本描述（及图生图场景下的参考图）生成更贴合意图的图片。
Skill 坐标为 @tencent-adm/hy-image-generation；SkillHub 页面标注 requires_api_key=true，使用前需要准备腾讯云侧 API 凭证，具体变量名与配置步骤以安装包内 SKILL.md 为准。
核心功能¶
以下能力均来自官方简介，未在资料中出现的参数或接口不写：
- 文生图：根据文字描述生成图片。
- 图生图：在已有图片基础上，按描述进行再生成或风格/内容调整（具体交互以 Skill 文档为准）。
- 混元生图 3.0：后端为腾讯云混元生图 3.0 能力，由 Skill 在 Agent 侧编排调用，减少自行对接 HTTP/SDK 的成本。
安装与启用¶
官方 SkillHub 页面建议：让 AI 按 SkillHub 安装与优先源配置 安装本 Skill。
1、安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可用官方脚本安装（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 HY Image Generation¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能识别不到。常见路径示例（以你实际环境为准）：
| Agent / 客户端 | Skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令：
skillhub install @tencent-adm/hy-image-generation --dir <你的 skills 目录>
也可先搜索再安装：
skillhub search hy-image-generation
skillhub install @tencent-adm/hy-image-generation --dir <你的 skills 目录>
3、API Key 与启用¶
Skill 标签标明需要 API Key。安装完成后，在对应 skills 目录下打开该 Skill 的 SKILL.md，按文档配置腾讯云凭证并确认 Agent 已加载该目录（部分客户端需重启或刷新技能列表）。不要在文章或仓库里硬编码密钥。
Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录路径 与各自如何刷新技能；安装命令本身均为 skillhub install，资料中未单独列出各客户端不同的安装包名。
典型用法¶
资料侧可复现的步骤是「安装 + 在对话中启用 Skill」：
- 按上一节将
@tencent-adm/hy-image-generation装到当前 Agent 的 skills 目录，并完成 API Key 配置。 - 在对话中说明需求，例如：为某段文案生成封面图、按参考图生成同风格变体、或根据分镜描述批量出图。Agent 在命中本 Skill 后，会按 SKILL.md 中的流程调用混元生图 3.0。
官方页面未公开独立的 curl 示例或固定 prompt 模板；具体请求字段、输出路径、图生图如何传参考图，以安装后的 SKILL.md 为准，避免与版本 v1.0.2 不一致。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，希望把「配图」变成对话内一步完成的团队或个人。
- 愿意使用腾讯云混元生图、并能自行申请与保管 API Key 的开发者。
限制与注意
- 企业来源 Skill（
enterprise），使用与计费以腾讯云混元生图产品及你的账号策略为准。 - 必须配置 API Key；未配置时 Skill 无法完成云端调用。
- 生成内容需遵守平台与腾讯云相关合规要求；商用前请核对服务条款与版权约定。
- SkillHub 统计（截至资料抓取）：评分 100000，下载 6436，安装 298；安装量低于下载量时，常见原因是未装到正确
--dir或未配置密钥。
结尾¶
HY Image Generation 把混元生图 3.0 的文生图、图生图能力接到 Agent 工作流里，适合用自然语言驱动配图、又不想每次从零对接云 API 的场景。安装走 SkillHub 标准流程，凭证与调用细节以包内文档为准。
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/hy-image-generation
- 官方地址：https://api.skillhub.cn/tencent-adm/hy-image-generation
- 安装说明：https://skillhub.cn/install/skillhub.md
