前言¶
做儿童向内容时,常见做法是手写分镜、再分别调图像 API 拼页。流程长,分辨率与密钥配置也容易在脚本里重复写。SkillHub 上的「儿童绘本生成器」把百度文心 ERNIE-Image-Turbo 的文生图能力包进标准 SKILL.md,并附带 scripts/generate_image.py,让 Agent 按固定步骤拆故事、写画面 prompt、落盘 PNG。下面介绍它是什么、能做什么,以及怎样安装与调用。
这是什么¶
「儿童绘本生成器」是社区发布的 OpenClaw 类 Agent Skill,坐标 @user_50478668/children-picture,当前商店版本为 1.0.0,分类 design-media,子类为 图片生成,来源 community。发布者账号为 user_50478668(SkillHub 展示名 livingbody)。SkillHub 标签标明 requires_api_key=true,使用前需自行准备百度 AI Studio 侧可用的 API Key。
官方入口:
- API 坐标页:https://api.skillhub.cn/user_50478668/children-picture
- 技能详情页:https://www.skillhub.cn/skills/user_50478668/children-picture
Skill 自述定位:基于百度文心图像模型,通过提炼儿童故事核心画面,用 Text-to-Image 生成绘本插图;底层通过 OpenAI 兼容客户端访问 https://aistudio.baidu.com/llm/lmapi/v3,模型名为 ERNIE-Image-Turbo。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 scripts/generate_image.py,可与 Zip 包对照核实。
文生图与绘本流程¶
设计上的数据流为:输入儿童故事或主题 → Agent 生成多个关键画面 prompt → 调用 generate_image.py 出图。单次调用生成一张图;批量生成在文档中标记为当前不支持。
分辨率¶
支持 7 种预设尺寸(--resolution 的 choices):1024x1024(默认)、1376x768、1264x848、1200x896、896x1200、848x1264、768x1376,覆盖方图、横屏与竖屏场景。
API Key 与客户端¶
Key 解析顺序:--api-key 参数优先,否则依次读取环境变量 ERNIE-Image_API_KEY、ERNIE_Image_API_KEY、BAIDU_API_KEY。未提供时会报错 Error: No API key provided. 并退出。
Prompt 与中文文字¶
Skill 对 prompt 采用透传为主;文档说明可在描述中指定画面中的中文文字、字体风格与位置,依赖模型侧的中文渲染能力。
社区侧数据(SkillHub,截至页面抓取)¶
- 下载 937 次,收藏 2 次,SkillHub 统计的安装次数为 0(以商店统计为准)。
- 安全扫描:Keen 为「安全,无风险」;另一路扫描标记为「可疑,存在潜在风险」。安装前建议在 SkillHub 详情页自行查看安全报告链接。
- 详情页 overviewMd 为空,完整说明以 Zip 包内
SKILL.md为准。
安装与启用¶
方式一:SkillHub CLI(推荐)¶
先按官方安装说明检查或安装 skillhub CLI,见 https://skillhub.cn/install/skillhub.md 。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落到 ./skills/ 可能不会被识别。
command -v skillhub && skillhub --version
skillhub install user_50478668/children-picture --dir ~/.cursor/skills/
常见 Agent 的 skills 路径(摘自同一安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下.agents/skills/
安装后按你所用客户端要求重启或刷新 Agent,使 Skill 被加载。
方式二:让 AI 按提示安装¶
SkillHub 页面提供的安装提示为:根据 https://skillhub.cn/install/skillhub.md ,安装 @user_50478668/children-picture。
方式三:Zip 包¶
详情页提供 Zip 下载(版本 1.0.0),地址形如:
https://api.skillhub.cn/api/v1/download?slug=@user_50478668/children-picture
解压后目录含 SKILL.md 与 scripts/generate_image.py,需手动放入对应 Agent 的 skills 目录并满足其加载规则。
运行依赖¶
脚本声明 Python 3.7+,依赖 openai 包(见脚本头部 inline metadata)。在 Skill 根目录或正确工作路径下执行 Python 命令。
配置 API Key¶
生产环境更稳妥的做法是设置用户级环境变量,避免在命令行长期暴露 Key:
export ERNIE-Image_API_KEY="你的百度 AI Studio Key"
Key 需在百度 AI Studio 开通与 ERNIE-Image 相关的图像生成能力;Skill 文末列出了 AI Studio 与模型介绍链接,可按需查阅申请流程。
典型用法¶
1、Agent 侧(绘本场景)¶
在 Skill 已启用且 API Key 可用时,可向 Agent 提供儿童故事全文或主题,让其:
- 拆出若干关键镜头,为每页写图像 prompt(可参考 Skill 中的英文结构化模板:主体、风格、构图、光影、背景、色彩、Avoid 等字段)。
- 对每个 prompt 调用脚本,指定输出文件名与分辨率(竖版页可用
896x1200或768x1376)。
2、命令行单图(Skill 官方示例)¶
在技能包目录执行,用于验证链路或单张插图:
python scripts/generate_image.py \
--prompt "A serene Japanese garden with cherry blossoms" \
--filename "japanese-garden.png" \
--resolution 1024x1024
竖屏壁纸示例(含临时 Key 参数,共享机器上慎用):
python scripts/generate_image.py \
--prompt "A mystical dark fantasy meadow with a glowing-eyed kitten..." \
--filename "wallpaper.png" \
--resolution 768x1376 \
--api-key "your-api-key-here"
调用前可按 Skill 建议做预检:
test -n "$ERNIE-Image_API_KEY" || echo "API Key 未设置"
成功时脚本将 base64 解码为 PNG 写入 --filename 指定路径,父目录不存在会自动创建;同名文件会被覆盖且无二次确认。
适用场景与注意¶
适合谁:需要在 Agent 工作流里为儿童故事、亲子内容或教育场景快速出插图,且已具备百度 AI Studio 图像 API 配额与 Key 的开发者或内容作者。
限制与坑:
- 必须配置 API Key;配额、鉴权失败或 prompt 触发内容策略时,需按 Skill 故障表调整 Key 或改写描述。
- 当前版本不支持脚本内批量出图;多页绘本需多次调用或由 Agent 循环执行。
--api-key会出现在进程列表中,临时调试用即可。- SkillHub 一侧安全扫描结果不完全一致,社区来源、作者未认证(
isAuthorVerified: false),生产环境请自行审阅SKILL.md与脚本后再启用。 - 商店元数据版本为 1.0.0;包内文档版本表若与商店不一致,以 SkillHub 发布的 Zip 1.0.0 为准。
结尾¶
「儿童绘本生成器」把 ERNIE-Image 文生图封装成 Agent 可执行的 Skill:固定脚本入口、七种分辨率与明确的 Key 约定,便于把故事拆成画面并落盘。若你要在 Cursor 等客户端里试用,可从 SkillHub 安装或下载 Zip,配置 ERNIE-Image_API_KEY 后按 SKILL.md 示例调用即可。
官方地址:https://api.skillhub.cn/user_50478668/children-picture