前言¶
在 Agent 里做图片生成,常见做法是手写 HTTP 调用、自己拼请求体,再轮询异步任务拿结果链接。百音开放平台提供文生图与图生图能力,但接口细节和任务状态查询仍要你自己接进对话流程。
下面介绍 SkillHub 上的 baiyin-image-generate-skill(坐标 @user_7b3c719e/baiyin-image-generate-skill)。它把百音开放平台的图片生成与任务进度查询封装成 Agent Skill,适合在 Cursor、Claude Code 等支持 SKILL.md 的环境里按需安装。
这是什么¶
baiyin-image-generate-skill 是社区来源(community)的 design-media 类 Skill,当前版本 1.0.5,由发布者 user_7b3c719e 维护。
一句话定位:为 Agent 提供百音开放平台的图片生成能力,覆盖文生图、基于参考图的图生图,以及查询任务进度并返回最终图片链接。
官方 SkillHub 页面:baiyin-image-generate-skill。API 元数据地址:https://api.skillhub.cn/user_7b3c719e/baiyin-image-generate-skill。
核心功能¶
以下能力与 SkillHub 简介及标签一致,未在资料中出现的接口名或参数不在本文展开。
- 文生图:用户希望通过百音开放平台根据文本描述生成图片时,由 Skill 引导或执行对应调用。
- 图生图:用户希望基于参考图生成变体或重绘时,走图生图路径。
- 任务与结果:支持查询图片任务进度,并在完成后返回最终图片链接。
标签 requires_api_key=true 表示使用前需要百音开放平台相关的 API 密钥;具体配置方式以安装后的 Skill 文档(SKILL.md)为准。
安装与启用¶
SkillHub 推荐先按 SkillHub 安装与优先源配置 准备 skillhub CLI,再把技能装到当前 Agent 实际读取的 skills 目录;装错目录会导致 Agent 识别不到。
检查 CLI¶
command -v skillhub && skillhub --version
未安装时,可按官方文档执行完整安装或仅安装 CLI(见 https://skillhub.cn/install/skillhub.md 中的 curl 命令)。
安装本 Skill¶
安装时必须用 --dir 指向当前环境的 skills 目录。例如 Cursor 常用路径为 ~/.cursor/skills/:
skillhub install user_7b3c719e/baiyin-image-generate-skill --dir ~/.cursor/skills/
也可将下面提示交给 Agent,由其按官方安装说明处理:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_7b3c719e/baiyin-image-generate-skill`。
其他客户端的 skills 路径(Claude Code、Codex、Windsurf 等)以 SkillHub 安装文档第四节列表为准;核实不到的路径不要自行假设。
安装后若 Agent 未立刻加载新 Skill,按你所用客户端的惯例重启或刷新技能目录。
典型用法¶
资料未提供可复制的请求示例或环境变量名,典型流程按官方「Use when」说明归纳如下:
- 在对话中说明需求:纯文生图、或提供参考图做变体/重绘。
- 确保已满足
requires_api_key=true所需的密钥配置(按 Skill 内说明操作)。 - 由 Agent 启用本 Skill,提交百音开放平台图片任务。
- 需要时查询任务进度,待完成后获取最终图片链接并在对话中返回。
具体工具步骤、参数与错误处理以安装包内的 SKILL.md 为准。
适用场景与注意¶
适合谁
- 已在或计划使用百音开放平台做图片生成的开发者。
- 希望把文生图、图生图和异步任务查询放进 Agent 工作流,而不是每次手写集成代码的团队。
使用注意
- 依赖外网与百音开放平台服务;密钥不要提交到仓库。
- SkillHub 页面统计(截至抓取):评分 100000,下载 751,安装 6;社区 Skill,升级前可在 SkillHub 查看版本是否仍为 1.0.5。
- 无 API 密钥或平台配额不足时,Skill 无法完成生成,需先在百音开放平台侧开通能力。
结尾¶
baiyin-image-generate-skill 把百音开放平台的文生图、图生图和任务结果查询收敛到一个可安装的 Agent Skill,减少重复对接成本。需要安装或更新时,以 SkillHub 为准:
- 页面:https://www.skillhub.cn/skills/user_7b3c719e/baiyin-image-generate-skill
- 坐标:
@user_7b3c719e/baiyin-image-generate-skill