前言¶
做兒童向內容時,常見做法是手寫分鏡、再分別調圖像 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