sk-doubao-seedream

支持使用火山方舟 Seedream 系列模型，通过文字描述生成图片或对已有图片进行编辑，包含多版本模型选择。

Security Scan

The skill's files, instructions, and requested settings are coherent with its stated purpose (using Volcengine/Ark Seedream models to generate/edit images) and do not request unrelated credentials or perform unexpected actions.

Purpose & Capability

Name/description claim image generation/editing via Volcengine Seedream; code and SKILL.md call Ark API endpoints, list Seedream model IDs, and require only an Ark API key — all consistent.

Instruction Scope

SKILL.md and scripts instruct only to set an API key (via config file or VOLCENGINE_API_KEY), choose models, provide prompts and optional input images; runtime code only reads its config, optionally an input image, and sends requests to the documented API endpoints. No broad file reads, unrelated env access, or unexpected external endpoints are present.

Install Mechanism

No install spec; this is an instruction-only skill with included Python scripts. No downloads, package installs, or archive extraction are performed by the skill files themselves.

Credentials

Only credential use is an API key (via config.json or VOLCENGINE_API_KEY). No unrelated secrets or multiple external credentials are requested; config is stored locally in the skill directory.

Persistence & Privilege

Skill does not request permanent platform-wide privileges (always:false), does not modify other skills, and only writes its own config.json in its skill directory.

Assessment

This skill appears to be what it says: it will send your prompts and any input images to the Volcengine/Ark API and will store an API key (if you choose to save it) in the skill's config.json located in the skill folder. Before installing, confirm you trust the Ark endpoint (https://ark.cn-beijing.volces.com) and only provide an API key that has the necessary image-generation permissions. If you prefer not to store credentials on disk, use the environment variable option or the session-only input path. Also be aware that prompts and images are transmitted to the external API (so avoid sending sensitive images or secrets).

Doubao Seedream Skill

火山方舟 Seedream 文生图 Skill，支持 Doubao-Seedream 系列模型。

API 文档: https://www.volcengine.com/docs/82379/1541523

功能特性

• 📝 文生图: 根据文字描述生成图片
• 🖼️ 图生图: 对已有图片进行编辑
• 🔄 多版本支持: Seedream 5.0 / 4.5 / 4.0 / 3.0

支持的模型

模型 ID	名称	类型
doubao-seedream-5-0-260128	Doubao-Seedream-5.0	文生图
doubao-seedream-4-5-251128	Doubao-Seedream-4.5	文生图
doubao-seedream-4-0-250828	Doubao-Seedream-4.0	文生图
doubao-seededit-3-0-i2i-250628	Doubao-SeedEdit-3.0-i2i	图生图
doubao-seedream-3-0-t2i-250415	Doubao-Seedream-3.0-t2i	文生图

首次使用

1. 检查/设置 API Key

运行任何命令前，系统会检查 API Key。如果没有设置或需要更新：

# 方式1: 交互式设置
python {baseDir}/scripts/generate.py config

# 方式2: 直接编辑配置文件
# 文件位置: {baseDir}/config.json
{
    "api_key": "your-api-key",
    "default_model": "doubao-seedream-4-0-250828",
    "output_dir": "./generated-images"
}

# 方式3: 设置环境变量
set VOLCENGINE_API_KEY=your-api-key

2. 获取 API Key

1. 访问 火山方舟控制台
2. 登录后进入「API Key 管理」
3. 创建或复制你的 API Key

使用方法

1. 查看模型列表

python {baseDir}/scripts/generate.py list

2. 命令行模式

文生图:

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

指定尺寸:

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

图生图:

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

3. 交互模式

python {baseDir}/scripts/generate.py

会依次引导你：

1. 选择模型
2. 选择模式（文生图/图生图）
3. 输入提示词
4. 生成图片

参数说明

参数	简写	说明	默认值
--prompt	-p	图片描述/编辑指令	-
--model	-m	模型 ID	doubao-seedream-4-0-250828
--output	-o	输出文件路径	seedream_output_{timestamp}.png
--input-image	-i	输入图片（图生图）	-
--size	-s	图片尺寸	1024x1024

支持的图片尺寸: 512x512, 768x768, 1024x1024, 1024x2048, 2048x1024

文件结构

sk-doubao-seedream/
├── SKILL.md           # 本文件
├── config.json        # 配置文件（API Key 等）
└── scripts/
    └── generate.py    # 主生成脚本

API 端点

• 基础 URL: https://ark.cn-beijing.volces.com/api/v3
• 文生图端点: POST /images/generations
• 图生图端点: POST /chat/completions

常见问题

Q: 提示 "API Key 无效" 或 "模型不存在"

A: 确保：

1. API Key 是火山方舟 Ark 服务的（不是 Atlas Cloud）
2. API Key 有图片生成模型的访问权限
3. 在火山方舟控制台检查模型权限

Q: 如何查看可用的模型？

A: 使用 list 命令查看所有支持的模型，或访问控制台的模型列表。

Q: 图片生成需要多长时间？

A: 通常 5-30 秒，视服务器负载而定。