前言¶

在 Cursor、Claude Code 等环境里做配图时，常见做法是临时写一段脚本去调云厂商图像 API，再把 Key、模型 ID、尺寸规则记在笔记里。下次换模型或做图生图，又要重新查文档。下面介绍 SkillHub 社区技能 sk-doubao-seedream（坐标 @user_1060c188/sk-doubao-seedream，当前版本 1.0.1）：把火山方舟 Ark 上的 Doubao Seedream / SeedEdit 调用封装成 Skill 自带的 Python 脚本与配置，Agent 可按 SKILL.md 引导你完成安装、配 Key 和生成图片。

这是什么¶

sk-doubao-seedream 是社区来源（source: community）的 design-media 类 Skill，SkillHub 子分类为「图片生成」。发布者为 user_1060c188（页面展示名 TryLoveCatch）。Skill 内说明其面向火山方舟 Seedream 文生图能力，并标注需自备 API Key（SkillHub 标签 requires_api_key=true）。

官方入口：

• API 资源页：https://api.skillhub.cn/user_1060c188/sk-doubao-seedream
• SkillHub 展示页：https://www.skillhub.cn/skills/user_1060c188/sk-doubao-seedream

火山方舟图像 API 文档（Skill 内引用）：https://www.volcengine.com/docs/82379/1541523

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与 scripts/generate.py 的说明与实现，未经 Skill 作者文档描述的不写入本文。

1. 文生图：根据文字提示词生成图片，默认模型为 doubao-seedream-4-0-250828。
2. 图生图：对已有图片按提示词编辑，使用模型 doubao-seededit-3-0-i2i-250628（edit 子命令）。
3. 多模型版本：内置 Seedream 5.0 / 4.5 / 4.0 / 3.0 及 SeedEdit 3.0 的模型 ID，可用 list 查看。
4. 调用方式：命令行参数模式、无参数时的交互引导模式；API 基础地址为 https://ark.cn-beijing.volces.com/api/v3（文生图 POST /images/generations，图生图 POST /chat/completions）。

支持的模型 ID（节选，完整列表以 generate.py list 为准）：

安装与启用¶

1. 安装 SkillHub CLI（如尚未安装）¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方说明执行完整安装（节选）：

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

说明文档：https://skillhub.cn/install/skillhub.md

2. 安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常用路径示例（来自 SkillHub 安装文档）：

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

在目标目录的父路径上执行（SkillHub 搜索索引给出的安装方式）：

skillhub install sk-doubao-seedream --namespace user_1060c188 --dir ~/.cursor/skills/

也可把安装说明交给 Agent：根据 https://skillhub.cn/install/skillhub.md 安装 @user_1060c188/sk-doubao-seedream。

安装成功后，技能目录一般为：

~/.cursor/skills/@user_1060c188/sk-doubao-seedream/

（具体路径随你选择的 --dir 而变化。）

Skill 包内 README.md 另提到可通过 npx clawhub@latest install sk-doubao-seedream 或复制到 ~/.workbuddy/skills/ 用于 WorkBuddy/OpenClaw；若你使用上述客户端，以各自文档为准。

3. 配置火山方舟 API Key¶

运行生成脚本前需要 Ark API Key。Skill 支持三种方式（见 SKILL.md）：

交互写入配置（在技能目录下执行，{baseDir} 即 @user_1060c188/sk-doubao-seedream 的安装路径）：

python {baseDir}/scripts/generate.py config

编辑 config.json：

{
    "api_key": "your-api-key",
    "default_model": "doubao-seedream-4-0-250828",
    "output_dir": "./generated-images"
}

环境变量（脚本优先读取 VOLCENGINE_API_KEY）：

export VOLCENGINE_API_KEY=your-api-key

Key 需在 火山方舟控制台 的「API Key 管理」中创建，并确保账号具备对应图片生成模型的访问权限。

典型用法¶

以下命令均假设当前工作目录为技能根目录，或已将路径替换为实际安装位置。

查看内置模型列表：

python scripts/generate.py list

文生图：

python scripts/generate.py generate -p "一只可爱的猫咪" -m "doubao-seedream-4-0-250828" -o "output.png"

指定尺寸（Skill 文档列出的可选值包括 512x512、768x768、1024x1024、1024x2048、2048x1024；5.0/4.5 等模型在脚本中默认 1920x1928）：

python scripts/generate.py generate -p "风景画" -s "1024x2048" -o "landscape.png"

图生图：

python scripts/generate.py edit -p "把这只猫变成老虎" -i "cat.png" -o "tiger.png"

交互模式（依次选择模型、文生图/图生图、提示词）：

python scripts/generate.py

在 Agent 会话中，可直接描述需求（模型、尺寸、输出路径），让 Agent 按 SKILL.md 调用上述命令；生成结果默认也可写入 config.json 中的 output_dir。

适用场景与注意¶

适合谁

• 已开通火山方舟 Ark、需要在编码 Agent 里稳定调用 Seedream 系列的用户。
• 希望用固定脚本封装 Key、模型 ID 和尺寸规则，减少每次手写 HTTP 请求的团队或个人。

限制与注意

1. 依赖与费用：调用的是火山方舟线上 API，产生计费与配额限制；Key 需自行保管，不要提交到公开仓库。
2. 模型与尺寸：不同模型支持的 size 不同（例如 5.0/4.5 在脚本中限定 1920x1928），不匹配时可能报错，生成前建议先 list 或查阅控制台权限。
3. SkillHub 页面信息：截至核对时，展示页 summary / overviewMd 为空，详细说明以安装包内 SKILL.md 为准；社区统计为下载 917 次、安装 3 次（页面内嵌数据，会随时间变化）。
4. 安全审核：SkillHub 页面展示该包经第三方安全扫描结果为「安全，无风险」，仍建议在可信环境安装并自行审查 scripts/generate.py 源码后再配置 Key。

结尾¶

sk-doubao-seedream 把火山方舟 Seedream 的文生图、图生图和多模型选择收敛到一个可安装的 Agent Skill：先通过 SkillHub 装进对应 skills 目录，再配置 VOLCENGINE_API_KEY 或 config.json，即可用 generate.py 在命令行或 Agent 对话里出图。更多元数据与安装入口见：https://www.skillhub.cn/skills/user_1060c188/sk-doubao-seedream。