前言¶
在 Cursor、Claude Code 等環境裏做配圖，常見做法是手寫 HTTP 請求、自己維護模型名和參數，或在對話裏反覆粘貼 API 文檔。Agnes 提供獨立的圖像生成接口，文生圖與圖生圖模型版本也不相同，接進 Agent 後更適合用自然語言觸發。下面介紹 SkillHub 社區 Skill agnes文生圖（@user_c28beb7a/agnes-image-gen），把 Agnes 圖片能力封裝成可被 Agent 加載的 SKILL 流程。
這是什麼¶
agnes文生圖 是發佈在 SkillHub 的社區 Skill（分類 design-media，當前版本 v2.0.5），由發佈者 user_c28beb7a 維護。它調用 Agnes AI 的圖片生成模型：文生圖使用 agnes-image-2.1-flash，圖生圖使用 agnes-image-2.0-flash。Skill 標註 requires_api_key=true，支持配置你自己的 Agnes API Key。計費方面，官方說明爲不消耗 WorkBuddy 積分，僅消耗 Agnes API 額度。
核心功能¶
依據 SkillHub 頁面與 API 摘要，已覈實能力如下。
- 文生圖（text-to-image）：通過提示詞生成圖片，模型爲
agnes-image-2.1-flash。 - 圖生圖（image-to-image）：在已有圖片基礎上按描述改寫或延展，模型爲
agnes-image-2.0-flash。 - 自定義 API Key：可使用自有 Agnes Key，額度與賬號策略由 Agnes 側決定。
- 生成取向：官方強調降低畫面「AI 感」、增強自然真實感；對中文配文強調邏輯連貫、字體排版，並減少文字重影重疊。
- 觸發加載：當用戶說「用 Agnes 生成圖片」「用 Agnes 畫一張」「Agnes 生成」，或明確要求使用 Agnes API 做文生圖/圖生圖時，Agent 應加載本 Skill。
安裝與啓用¶
SkillHub 提供的安裝方式是指令式：讓當前 AI 按統一安裝文檔拉取 Skill 包，而不是在本機手動 git clone。
向 Agent 發送下面這段話即可完成安裝指引（原文來自 SkillHub 技能頁）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c28beb7a/agnes-image-gen`。
安裝文檔 https://skillhub.cn/install/skillhub.md 會說明 Cursor、Codex CLI、Claude Code 等客戶端的差異；按你使用的工具跟隨該文檔中的目錄與配置步驟即可。本 Skill 需要 API Key，安裝後按 SKILL 內說明配置 Agnes Key（具體字段名以安裝後倉庫中的 SKILL.md 爲準）。
典型用法¶
本 Skill 面向對話觸發，而非單獨 CLI。在已安裝並配置 Key 的前提下，可按場景這樣說：
文生圖示例（示意提示，非固定 API 參數）：
用 Agnes 畫一張：秋日傍晚的城市天台，膠片質感，遠處有暖色燈光，畫面裏不要水印。
圖生圖示例：
用 Agnes 生成：以當前這張產品圖爲參考，改成淺灰背景，保留產品主體，風格更寫實。
或直接使用官方列出的觸發語，例如「用 Agnes 生成圖片」「Agnes 生成」，並在同一句裏寫清畫面描述或修改意圖。Agent 加載 Skill 後會按 SKILL.md 中的流程調用 Agnes 接口；返回結果一般爲生成圖片的路徑或展示方式，以 Skill 實現爲準。
適用場景與注意¶
適合誰
- 已在用 Agnes API，希望在 Agent 對話裏統一走文生圖/圖生圖，而不每次手寫請求。
- 需要中文海報、配圖類需求，且關注中文文字排版與少「AI 感」的官方優化方向。
- 希望配圖消耗走 Agnes 額度，而不是 WorkBuddy 積分（以官方說明爲準）。
限制與注意
- 必須自備並配置 Agnes API Key；未配置時 Skill 無法完成調用。
- 文生圖與圖生圖對應不同模型版本，圖生圖需能提供參考圖或上下文中的圖片。
- SkillHub 統計（頁面展示）：評分 100000，下載 5427 次；社區來源，升級以 SkillHub 上 v2.0.5 及後續版本爲準。
- 額度、限速、內容策略以 Agnes 平臺當前規則爲準，本文不替代其官方文檔。
結尾¶
agnes文生圖 把 Agnes 的 agnes-image-2.1-flash（文生圖）與 agnes-image-2.0-flash（圖生圖）接到 Agent 工作流裏，用固定觸發語即可加載，並支持自有 API Key。需要安裝或查看說明時，打開 SkillHub 技能頁或 API 摘要地址：
- SkillHub：https://www.skillhub.cn/skills/user_c28beb7a/agnes-image-gen
- API 摘要：https://api.skillhub.cn/user_c28beb7a/agnes-image-gen
