前言¶

在 Cursor、Claude Code 等環境裏寫文案時，配圖往往要切到獨立生圖產品，再手動下載、貼回對話。若希望 Agent 根據自然語言直接出圖並落到本地路徑，需要一套可複用的調用流程：API Key 配置、模型參數、尺寸約束和腳本入口都要寫進 Skill，而不是每次臨時查文檔。

下面介紹 SkillHub 社區 Skill「豆包生圖」（@user_8342f237/doubao-image-v2）。它把火山引擎 Ark 上的豆包 Seedream 模型封裝成 Agent 可執行的步驟，適合已有 Ark 賬號、希望在對話裏完成文生圖或圖生圖的開發者。

這是什麼¶

「豆包生圖」是 SkillHub 上分類爲 design-media 的社區 Skill（來源 community，發佈者 user_8342f237，頁面顯示作者爲厭冬）。一句話定位：通過環境變量 ARK_API_KEY 調用字節跳動火山引擎 Ark API（豆包 Seedream），完成文生圖、圖生圖與多圖融合，並由內置 Python 腳本把結果下載到本地。

與「自己寫一段 curl」相比，Skill 裏固定了默認模型、尺寸說明、參數表和 scripts/generate_image.py 入口，Agent 在用戶說出觸發意圖時按同一套流程執行。

SkillHub 頁面（截至抓取）版本爲 v1.0.0；商店側評分 100000，下載 1482 次；標籤含 requires_api_key=true。

核心功能¶

以下能力均來自 Skill 包內 SKILL.md 與 references/api_reference.md：

1. 文生圖：根據 prompt 生成圖片，默認模型 doubao-seedream-4-5-251128。
2. 圖生圖 / 多圖融合：通過 --image 傳入參考圖 URL（單圖字符串或多圖列表，參考文檔說明多圖最多 14 張，且輸入參考圖數量與生成數量合計不超過 15 張）。
3. 批量生成：--n 指定生成張數。
4. 尺寸與格式：支持 2k、4k、WIDTHxHEIGHT 等形式；文檔強調 seedream-4-5 對最小像素、1:1 / 9:16 等比例寫法有約束，詳見 Skill 內「尺寸選擇指南」。
5. 提示詞優化：腳本支持 --optimize standard（Skill 推薦在文生圖時啓用）。
6. 本地落盤：腳本調用 API 後下載圖片，將保存路徑返回給用戶。

官方描述的觸發場景包括：生成圖片、文生圖、畫圖、AI 畫圖、豆包生圖、生圖、生成插畫、AI 配圖等自然語言意圖。

安裝與啓用¶

1. 安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已安裝：

command -v skillhub && skillhub --version

未安裝時可按 SkillHub 官方安裝說明執行完整安裝或僅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安裝「豆包生圖」到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。SkillHub 文檔給出的常見路徑如下：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝命令（與 SkillHub 搜索結果一致）：

skillhub install doubao-image-v2 --namespace user_8342f237 --dir ~/.cursor/skills

也可讓 Agent 按 SkillHub 安裝說明 安裝座標 @user_8342f237/doubao-image-v2。

3. 配置 Ark API Key¶

Skill 要求必填環境變量 ARK_API_KEY，說明爲火山引擎 Ark API Key，從控制台獲取：

export ARK_API_KEY=ark-xxxxxxxx

獲取路徑：登錄 火山引擎控制台 → 模型推理 → 創建 API Key。

API 側 Base URL 爲 https://ark.cn-beijing.volces.com/api/v3，認證方式爲 Bearer Token（即上述 Key）。

4. Python 依賴¶

首次運行 scripts/generate_image.py 時，Skill 說明會嘗試自動安裝 volcengine-python-sdk[ark]。若失敗，可手動執行：

pip install "volcengine-python-sdk[ark]"

典型用法¶

Skill 約定的工作流是：確認用戶需求 → 運行 generate_image.py → 把本地圖片路徑交給用戶。下面示例中的 <skill_dir> 替換爲本 Skill 安裝目錄（例如 ~/.cursor/skills/@user_8342f237/doubao-image-v2）。

基礎文生圖（推薦帶提示詞優化）：

python <skill_dir>/scripts/generate_image.py --prompt "一隻橘貓慵懶地趴在窗臺上曬太陽，寫實風格，柔光" --optimize standard --output ./cat.png

指定豎屏尺寸（如手機壁紙）：

python <skill_dir>/scripts/generate_image.py --prompt "城市夜景海報" --size 1440x2560 --optimize standard --output ./poster.png

圖生圖（參考圖 URL）：

python <skill_dir>/scripts/generate_image.py --prompt "將場景改爲夜晚" --image "https://example.com/input.png" --output ./night.png

一次生成多張：

python <skill_dir>/scripts/generate_image.py --prompt "水彩花卉插畫" --n 3 --output ./flower.png

在對話裏使用時，用戶只說「幫我畫一隻貓」時，Skill 允許 Agent 直接使用默認參數（如尺寸 2k、數量 1）生成，無需逐項追問。

若需直接對照 Ark 接口字段，可閱讀 Skill 包內 references/api_reference.md；其中也給出使用 volcenginesdkarkruntime.Ark 的 Python 示例（文生圖、單圖參考、多圖融合）。

適用場景與注意¶

適合誰

• 已有火山引擎 Ark 賬號與 API Key，希望在 Agent 對話裏完成配圖、插畫或簡單圖生圖改圖。
• 希望把 Seedream 的模型 ID、尺寸限制和腳本調用方式固化在 Skill 中，減少重複查文檔。

使用上需要注意

1. 計費與密鑰：requires_api_key=true，Key 需自行在控制台申請並妥善保管，不要寫入公開倉庫。
2. 尺寸與模型限制：api_reference.md 寫明 seedream-4-5 對部分參數（如 output_format、watermark）不支持；返回的圖片 URL 通常約 24 小時有效，Skill 腳本會下載到本地，但仍需及時備份。
3. 提示詞長度：不超過 300 漢字或 600 英文單詞。
4. 版本信息：SkillHub 列表爲 v1.0.0；包內 SKILL.md frontmatter 可能標更高版本號，以你 skillhub install 得到的包內容爲準。

結尾¶

「豆包生圖」把豆包 Seedream 的文生圖、圖生圖能力收斂成 Agent 可執行的腳本與參數表，核心依賴只有 ARK_API_KEY 與 Python SDK。安裝到對應客戶端的 skills 目錄並配置密鑰後，即可在對話裏用自然語言觸發生圖。

官方 Skill 地址：https://api.skillhub.cn/user_8342f237/doubao-image-v2
SkillHub 展示頁：https://www.skillhub.cn/skills/user_8342f237/doubao-image-v2