前言¶
在 Agent 裏做配圖,常見做法是接一家固定雲廠商的官方 SDK,或自己維護多套 HTTP 調用腳本。模型一換,Base URL、鑑權方式和請求體往往都要改一遍。若你已經在用第三方「中轉 API」(同一套 Key 和網關地址背後聚合多種圖像模型),更需要的是:讓 Agent 按統一流程走文生圖、圖生圖和多圖任務,而不是每次在對話裏重複貼 endpoint 和參數說明。
下面介紹 SkillHub 上的 生圖外掛.Skill(座標 @user_2c58fc0f/ch12893719743826428329324),它通過用戶自備的中轉接口接入 GPT Image 2.5、Nano Banana 2.1 等模型,把圖像能力掛到任意支持 Skills 的 Agent 上。
這是什麼¶
生圖外掛.Skill 是 SkillHub design-media 分類下的社區 Skill(來源:community),當前頁面版本爲 v5.2.1,發佈者爲 user_2c58fc0f(SkillHub 頁面作者顯示爲 HenryChen)。
一句話定位:讓 Agent 經中轉 API 調用圖像模型,完成 文生圖、圖生圖、多圖創作;Skill 標籤標明 requires_api_key=true,需要你自己提供可用的 API Key(及對應中轉服務)。
官方頁面:https://www.skillhub.cn/skills/user_2c58fc0f/ch12893719743826428329324
核心功能¶
以下能力均來自 SkillHub 官方簡介,未在頁面單獨展開的實現細節不作延伸描述。
- 中轉接入多類圖像模型:通過中轉網關使用 GPT Image 2.5、Nano Banana 2.1 等(頁面表述爲「等」,未逐一列出完整模型表)。
- 文生圖:根據自然語言描述生成圖像。
- 圖生圖:在已有圖像基礎上按提示修改或重繪(頁面與同類 Skill 的常見能力對齊,具體參數以 Skill 內說明爲準)。
- 多圖創作:支持多圖相關創作場景(官方簡介中的「多圖創作能力」,未在公開頁給出逐步示例)。
安裝與啓用¶
SkillHub 推薦先安裝 skillhub CLI,再把 Skill 安裝到當前 Agent 實際讀取的 skills 目錄;裝錯目錄會導致 Agent 識別不到,需重啓或重新加載後生效。安裝流程以 https://skillhub.cn/install/skillhub.md 爲準。
1、檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安裝,可使用官方一鍵腳本(完整安裝含 CLI 與默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
將 @user_2c58fc0f/ch12893719743826428329324 安裝到你當前環境的 skills 目錄。--dir 必須指向 Agent 配置的目錄,例如 Cursor 常用路徑爲 ~/.cursor/skills/:
skillhub install @user_2c58fc0f/ch12893719743826428329324 --dir ~/.cursor/skills/
其他客戶端的常見目錄(同樣來自 SkillHub 安裝文檔,按你實際使用的工具替換 --dir):
- Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/ - Windsurf:
~/.codeium/windsurf/skills/或項目.windsurf/skills/
安裝完成後,按所用 Agent 的要求重啓或刷新 Skills 列表。
3、API Key 與中轉服務¶
Skill 標記 requires_api_key=true:你需要自行準備中轉服務商提供的 API Key,以及該服務要求的 Base URL / 模型 ID 等信息。公開 SkillHub 頁面未列出固定配置文件名或字段 schema;首次在對話裏啓用生圖時,應把中轉商文檔中的 endpoint、模型名和 Key 交給 Agent,並確認 Skill 內是否會把配置寫入本地(以安裝包內 SKILL.md 爲準)。
典型用法¶
公開頁未附帶可複製的一鍵 curl 示例,可復現的流程如下。
- 完成上一節的 CLI 安裝與
skillhub install。 - 在 Agent 對話中說明要使用 生圖外掛.Skill,並給出任務類型,例如:「文生圖,豎版海報,標題某某」或「參考這張圖做圖生圖,保持構圖、換背景」。
- 按 Agent 提示補全 中轉 API 的 Key 與模型標識(僅在你信任的環境提供 Key;勿提交到公開倉庫)。
- 生成結果一般爲圖片文件或 Agent 可訪問的 URL,保存路徑取決於 Skill 腳本與 Agent 工作區策略。
若你使用 Cursor,安裝目錄爲 ~/.cursor/skills/ 後,在同一項目裏直接描述圖像需求即可,由 Agent 加載 Skill 後調用中轉接口。
適用場景與注意¶
適合誰
- 已在用或計劃用第三方圖像中轉 API,希望 Agent 統一走 Skill 流程,而不是手寫多份調用代碼。
- 需要在對話裏快速切換 GPT Image 2.5、Nano Banana 2.1 等頁面提到的模型能力,做配圖、改版、多圖類任務。
限制與注意
- 依賴外部中轉:畫質、限速、計費與合規由你選擇的網關決定,Skill 本身不替代服務商 SLA。
- Key 安全:
requires_api_key=true意味着 Key 會進入 Agent 運行上下文;僅在可信環境使用,並遵循中轉商密鑰輪換建議。 - 版本與統計:SkillHub 頁面當前爲 v5.2.1;社區 Skill 的下載量、評分會隨時間變化,以安裝前頁面顯示爲準。
- 未公開細節勿臆測:例如具體 OpenAI 兼容路徑、Gemini 原生協議字段、NewAPI / One API 適配方式等,在未安裝 Skill 並閱讀其
SKILL.md前,本文不寫入未覈實配置項。
結尾¶
生圖外掛.Skill 把「中轉 API + 多模型圖像能力」封裝成 Agent 可加載的 Skill,面向文生圖、圖生圖與多圖創作;安裝座標爲 @user_2c58fc0f/ch12893719743826428329324,需自備 API Key。詳情與安裝入口:https://www.skillhub.cn/skills/user_2c58fc0f/ch12893719743826428329324