前言¶

在自己的項目裏接入圖像生成，常見兩條路：一是把模型廠商的私有 SDK 和一套 prompt 參數自己封一遍，二是找一個標準協議的入口，讓代碼只依賴 images API 的形狀，不綁定某一家實現。agnes-圖像生成屬於後一種。下面介紹這個 Skill 是什麼、能做什麼、以及目前資料裏能覈實到的接入信息。

這是什麼¶

agnes-圖像生成（座標 @user_69c32a7b/agnes-image）是一個社區來源的 Skill，發佈者爲 user_69c32a7b，版本 1.0.0，分類 design-media，在 SkillHub 上的標籤爲 requires_api_key=true。

它解決的問題很具體：用戶提出”生成圖片 / AI 繪畫 / 文生圖 / 圖生圖 / 編輯圖片”這類需求時，由 Skill 把這些意圖映射到 Agnes Image 2.1 Flash 模型上，調用方式遵循 OpenAI 兼容的 images API。也就是說，接入方拿到的是一個協議上熟悉的接口，而不是一套需要重新學習的參數體系。

需要說明的是，SkillHub 頁面顯示該 Skill 來源爲 community，不是官方模型方直接維護，使用前建議自行確認發佈者與模型服務方的關係。

核心功能¶

以下能力均來自官方簡介，未做額外推斷。

1、文生圖（text-to-image）：根據文本描述生成圖像。
2、圖生圖（image-to-image / img2img）：以已有圖片爲起點做生成或編輯。
3、圖像編輯：簡介中明確列出”edit an image with AI”，屬於對已有圖像的修改而非重畫。

模型爲 Agnes Image 2.1 Flash，調用層是 OpenAI 兼容的 images API。

觸發詞覆蓋中英文：生成圖片、AI繪畫、文生圖、圖生圖、Agnes圖片、agnes-image、generate image、create picture。這意味着用戶在對話裏用自然語言提需求即可，不需要記命令。

安裝與啓用¶

已抓取資料裏沒有給出官方安裝命令、目錄規範或具體配置字段，因此本節只列出能覈實到的信息，不提供未經覈實的命令。

1、訪問地址：https://api.skillhub.cn/user_69c32a7b/agnes-image（該地址在抓取時返回失敗，建議直接打開 SkillHub 頁面確認）。
2、SkillHub 頁面地址：https://www.skillhub.cn/skills/user_69c32a7b/agnes-image
3、憑據要求：標籤 requires_api_key=true，說明調用需要 API Key，密鑰的具體獲取位置資料未寫明，需按發佈者指引確認。
4、Cursor、Codex CLI、Claude Code 等不同宿主的啓用方式差異，資料中沒有分別說明，這裏不做推測。

如果要接入，建議先把上一節的調用協議驗證通，再決定是否把這個 Skill 裝進自己的環境。

典型用法¶

資料中沒有官方給出的可復現調用示例，下面這個示意只依據簡介裏”OpenAI-compatible images API”這一描述，用於說明調用形狀，具體字段名需要以實際服務返回爲準。

curl -X POST https://<服務地址>/v1/images/generations \
  -H "Authorization: Bearer $AGNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "agnes-image-2.1-flash", "prompt": "一隻在雨天屋頂上的貓", "n": 1}'

這是文生圖的常規形狀：POST 到 images/generations，帶 Bearer 令牌，prompt 傳描述。圖生圖在這類接口裏通常額外傳 image 字段，具體是否支持、字段名爲何，資料沒有寫，使用前需要向服務方確認。

適用場景與注意¶

適合的場景：

1、已經在用 OpenAI 兼容 images API 的代碼庫，想換一個生成後端而不改寫協議層。
2、對話式應用裏希望用自然語言觸發圖像生成或編輯，不想自己維護意圖識別。
3、需要文生圖與圖生圖共用同一個入口。

需要注意的點：

1、來源爲 community，評分與下載量來自 SkillHub 頁面（抓取時爲 100000 分、1373 次下載、0 次安裝），安裝數爲 0 說明實際使用者很少，穩定性需要自行驗證。
2、必須提供 API Key，密鑰來源和計費方式資料未說明。
3、模型名”Agnes Image 2.1 Flash”中的 Flash 一般對應較快、成本較低的檔位，但在圖像生成場景下畫質是否滿足業務要求需要實測。
4、簡介同時提到 generation 和 editing，兩者對提示詞的要求差異較大，建議分開測試。

結尾¶

這個 Skill 的價值在於把”生成或編輯圖像”這類需求收斂到一個 OpenAI 兼容的 images API 上，文生圖和圖生圖都能覆蓋，接入方不必爲每個模型廠商重寫一遍協議。它的短板也同樣清楚：社區來源、安裝量低、安裝與配置信息在現有資料裏不完整。適合先拿一個調用做驗證，再決定是否長期依賴。

官方地址：https://api.skillhub.cn/user_69c32a7b/agnes-image
SkillHub 頁面：https://www.skillhub.cn/skills/user_69c32a7b/agnes-image