Seedream 图像生成技能

此技能提供调用火山引擎 Ark 大模型服务平台图像生成模型（Seedream）的方法。

选择运行环境

脚本提供了 Python 和 JavaScript 两种实现：

• 如果您的运行环境主要为 Node.js/TypeScript 或 Web 模块，建议使用 scripts/seedream.js。
• 如果您的运行环境涉及复杂数据分析、批量调度或纯 Python 场景，建议使用 scripts/seedream.py。

支持的模型参数（模型 ID / 端点 ID）

调用时，model 参数需为 Ark 控制台中部署的端点 ID（例如：ep-202X...），该端点必须基于以下基础图像生成模型之一：

• doubao-seedream-5-0-260128
• doubao-seedream-4-5-251128
• doubao-seedream-4-0-250828

脚本参数

调用图像生成功能时，需传入特定参数以控制生成行为。可用参数如下：

• model *(字符串，可选)*：对应模型的端点 ID。默认值为 doubao-seedream-5-0-260128。
• prompt *(字符串，必填)*：用于生成图像的文本描述。
• size *(字符串，可选)*：目标图像尺寸。支持 "2K"、"3K"、"4K"。

- doubao-seedream-5-0 支持 2K 和 3K。

- doubao-seedream-4 和 doubao-seedream-4-5 支持 2K 和 4K。

- 若未提供，该参数将完全忽略，不会发送至 API 请求。

- 也可在 prompt 中直接指定期望分辨率。强烈建议在 prompt 中明确写出分辨率，以获得最佳效果。

• image *(字符串或字符串列表，可选)*：本地图像路径或图像路径列表，用于图像到图像生成。脚本会读取本地文件，转换为 base64 后作为请求的 image 字段发送。
• watermark *(布尔值，可选)*：是否添加火山引擎 AI 水印。未提供时默认为 false。
• optimize_prompt_options *(对象，可选)*：配置自动提示词优化选项。格式为 JSON 对象。例如：{"mode": "standard"}。
• tools *(对象列表，可选)*：模型能力选项，格式为 JSON。示例：[{"type": "web_search"}]。
• output_format *(字符串，可选)*：输出图像格式。支持 png、jpeg。
• sequential_image_generation *(字符串，可选)*：连续图像生成策略（例如："auto"）。
• download_dir *(字符串，可选)*：本地保存生成图像的目录。若不提供，则不会本地下载图像，仅返回 API 响应。

推荐的宽高值

使用示例

Python 示例：

python3 <current_skill_dir>/scripts/seedream.py \
  --prompt "一只可爱的橙色猫咪躺在阳光下" \
  --model "ep-xxxxx..." \
  --size "2048x2048" \
  --watermark "false" \
  --output_format "png"

Node.js 示例：

node <current_skill_dir>/scripts/seedream.js \
  --prompt "一只可爱的橙色猫咪躺在阳光下" \
  --model "ep-xxxxx..." \
  --size "2048x2048" \
  --watermark "false" \
  --output_format "png"

python3 <current_skill_dir>/scripts/seedream.py \
  --prompt "将这张产品照片转为干净白底的电商图片" \
  --image "/path/to/source.png" \
  --model "ep-xxxxx..."

包含下载目录的示例：

python3 <current_skill_dir>/scripts/seedream.py \
  --prompt "壮丽的山间日落景色" \
  --download_dir "/Users/vincent/Downloads/generated_images" \
  --model "ep-xxxxx..."

python3 <current_skill_dir>/scripts/seedream.py \
  --prompt "未来感十足的城市景观" \
  --model "ep-xxxxx..." \
  --optimize_prompt_options '{"mode": "standard"}' \
  --tools '[{"type": "web_search"}]'

故障排查

如脚本运行出现问题，请检查以下内容：

• SEEDREAM_API_KEY：(环境变量，必填) 确保已正确设置该 API 密钥。它是火山引擎 Ark 的核心认证凭证。
• SEEDREAM_BASE_URL：(环境变量，可选) 若使用自定义端点，请确保其配置正确。默认值为 https://ark.cn-beijing.volces.com/api/v3/images/generations。

更多详细 API 文档请访问：[https://www.volcengine.com/docs/82379/1541523?lang=zh](https://www.volcengine.com/docs/82379/1541523?lang=zh)

如需查询最新的模型 ID 列表或更新当前文档中的“支持的模型参数”，请访问：[https://www.volcengine.com/docs/82379/1330310?lang=zh#36969059](https://www.volcengine.com/docs/82379/1330310?lang=zh#36969059)，并相应更新 seedream-image-generation/SKILL.md 文件中的“支持的模型参数”部分。