前言¶
在對話式 Agent 裏出圖,常見做法是接通用多模態接口或平臺內置繪圖。前者往往要自己在 SKILL 裏封裝鑑權、模型選擇與參數;後者則容易和宿主產品的積分、配額綁在一起。若你已經在用 Agnes AI 的圖片能力,或希望出圖更偏自然真實、中文配文更穩,需要一個按 Agnes 模型規格寫好、且能用自有 Key 的 Skill,agnes-image-gen 就是面向這一場景的社區技能。
這是什麼¶
agnes-image-gen 是 SkillHub 上座標爲 @user_15292d5a/yjkj-agnes-image-gen 的社區 Skill(design-media 分類,當前版本 1.0.0)。發佈者爲 user_15292d5a,標籤標明 requires_api_key=true,即運行前需配置 Agnes API Key。
它把 Agnes AI 的圖片生成模型接到符合通用 SKILL.md 約定的 Agent 工作流裏:用戶用自然語言描述需求時,Agent 加載本 Skill,按規則調用 Agnes 完成文生圖或圖生圖。官方說明中強調:調用 不消耗 WorkBuddy 積分,只消耗 Agnes API 額度。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取簡介,未單獨列出的接口字段或腳本不在本文展開。
文生圖¶
使用模型 agnes-image-2.1-flash,根據文本提示生成圖片。
圖生圖¶
使用模型 agnes-image-2.0-flash,在參考圖基礎上按提示改寫或延展畫面。
自定義 API Key¶
支持配置用戶自己的 Agnes Key,由用戶在自有 Agnes 賬戶下計費與控量,而不是走宿主產品的繪圖積分。
生成效果取向¶
Skill 簡介中的優化重點包括:
- 降低畫面「AI 感」,增強自然、真實感;
- 改善中文配文的邏輯連貫性、字體與排版;
- 減輕文字重影、重疊類常見問題。
何時加載本 Skill¶
當用戶說出例如「用 Agnes 生成圖片」「用 Agnes 畫一張」「Agnes 生成」,或明確要求使用 Agnes API 做文生圖 / 圖生圖時,Agent 應加載本 Skill。具體觸發與參數約定以安裝後的 SKILL.md 爲準。
安裝與啓用¶
SkillHub 官方給出的安裝方式有兩類:讓 AI 按安裝文檔操作,或在本機用 skillhub CLI 安裝到當前 Agent 的 skills 目錄。
方式一:提示詞交給 AI¶
將下面意圖發給支持 Skill 的客戶端(表述以 SkillHub 頁面爲準):
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_15292d5a/yjkj-agnes-image-gen`。
方式二:skillhub CLI¶
1、若尚未安裝 CLI,可先檢查:
command -v skillhub && skillhub --version
2、未安裝時,可按 SkillHub 安裝文檔執行完整安裝或僅 CLI(文檔地址:https://skillhub.cn/install/skillhub.md)。
3、安裝本 Skill 時 必須 使用 --dir 指向當前 Agent 的 skills 目錄,否則默認落在 ./skills/ 可能不會被識別:
skillhub install @user_15292d5a/yjkj-agnes-image-gen --dir <skills 目錄>
常見客戶端 skills 路徑(摘自 SkillHub 安裝文檔,以你本機實際爲準):
| 客戶端 | skills 目錄 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安裝完成後,按各客戶端要求配置 Agnes API Key(Skill 標籤要求 requires_api_key=true)。密鑰字段名與示例以 Skill 包內 SKILL.md 爲準;本文不臆造配置項名稱。
典型用法¶
公開頁面未提供獨立 REST 示例或固定 prompt 模板,用法以 對話觸發 + Skill 內說明 爲主。可復現的入口如下。
1、確認 Skill 已裝入對應 --dir,且 Agnes Key 已配置。
2、在對話中明確走 Agnes,例如:
用 Agnes 畫一張:清晨城市天際線,薄霧,紀實攝影風格,不要誇張 HDR。
3、圖生圖場景下,在支持附件的客戶端上傳參考圖,並說明意圖,例如:
用 Agnes 生成:保持這張產品圖的光影,把背景換成簡約淺灰展臺,中文標題「秋日限定」排版清晰、無重影。
Agent 加載 agnes-image-gen 後,應分別選用 agnes-image-2.1-flash(文生圖)或 agnes-image-2.0-flash(圖生圖)。生成結果路徑、格式以 Skill 實現與 Agnes API 返回爲準。
適用場景與注意¶
適合誰
- 已在使用或計劃使用 Agnes 圖片 API,希望在 Cursor、Claude Code、Codex 等 Agent 裏用同一套 Key 出圖;
- 需要海報、配圖等帶 中文文案 的畫面,且希望 Skill 側針對「AI 感」與文字排版做過取向說明;
- 希望繪圖計費與 WorkBuddy 積分 脫鉤,只走 Agnes 額度。
限制與注意
- 必須自備並妥善保管 Agnes API Key;勿將 Key 寫進公開倉庫或聊天記錄。
- SkillHub 統計(以腳本抓取爲準):評分 100000,下載 1944;頁面展示的安裝次數爲 0,可能與統計口徑有關,不影響按上述命令安裝。
- 社區來源(
community),升級與維護節奏取決於發佈者;生產環境使用前建議在測試 Key 下驗證效果與配額。 - 未在官方簡介中出現的模型版本、價格、速率限制,請以 Agnes 官方文檔爲準。
結尾¶
agnes-image-gen 把 Agnes 的 agnes-image-2.1-flash 文生圖與 agnes-image-2.0-flash 圖生圖封裝成可安裝的 Agent Skill,支持自有 Key,並針對更自然的畫面與更穩的中文配文做了產品向說明。安裝與座標以 SkillHub 爲準。
- SkillHub 頁面:https://www.skillhub.cn/skills/user_15292d5a/yjkj-agnes-image-gen
- 資源地址:https://api.skillhub.cn/user_15292d5a/yjkj-agnes-image-gen
- 安裝說明:https://skillhub.cn/install/skillhub.md