mcpField
G
generate-image-by-seedream

generate-image-by-seedream

github.com/chunpuCreative & media3988 installsUpdated 30w ago
Repository

About generate-image-by-seedream

This skill uses a script to generate or edit images with ByteDance Seedream models. It supports text-to-image, image-to-image, and multiple reference images, with parameters set through CLI arguments or YAML.

Key features

  1. 01Generate images from text or images
  2. 02Use URL and local reference images
  3. 03Configure generation with YAML
  4. 04Set model version and output size
  5. 05Override config with CLI arguments

Use cases

  1. 01Create images from text descriptions
  2. 02Edit or combine images using references
  3. 03Reuse image-generation settings in YAML

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/chunpu/agent-skills --skill generate-image-by-seedream

After installing, type/generate-image-by-seedreamin Claude Code to confirm it loaded.

Bundled filesREADME.mdscripts/generate_image.py

Details

From the project README

豆包 Seedream 图像生成

使用附带的脚本通过字节跳动图像生成模型生成或编辑图片：

  • 豆包 Seedream（即梦 / Dreamina） 系列生图模型
  • 支持文生图、图生图、多图参考编辑

默认版本：4.5 → 对应 doubao-seedream-4-5-251128。 默认尺寸：2K。

模型效果建议
  • 效果排序：4.5 > 5.0 > 4.0
  • 推荐优先使用 4.5 版本以获得最佳效果
画面比例
  • 必须在生图提示词（prompt）中明确指定画面比例，例如：“生成可爱小狗，9:16竖屏比例”

文生图

uv run {baseDir}/scripts/generate_image.py --prompt "你的图片描述" --filename "可爱小狗.jpg"

使用 YAML 配置文件

可以将所有生图参数写入 YAML 配置文件，然后通过 --config 参数使用：

文生图配置示例 (text2image.yaml)：
prompt: 一只可爱的小狗在草地上，9:16竖屏比例
filename: 可爱小狗.jpg
size: 2K
version: 4.5
图生图配置示例（带参考图列表，image2image.yaml）：
prompt: 将图1的服装换为图2的服装
filename: 换装女孩.jpg
images:
  - https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png
  - https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png
size: 2K
version: 4.5
本地参考图配置示例 (local_images.yaml)：
prompt: 多图融合成一张插画
filename: 多图融合插画.jpg
images:
  - /path/to/参考图1.jpg
  - /path/to/参考图2.png
size: 2K
version: 4.5
使用方法：
uv run {baseDir}/scripts/generate_image.py --config image2image.yaml
混合使用配置文件和命令行参数（命令行参数优先级更高）：
uv run {baseDir}/scripts/generate_image.py --config prompt.yaml --filename "自定义文件名.jpg"
YAML 配置文件支持的所有参数：
  • prompt: 图片描述
  • filename: 输出文件名
  • images: 参考图像列表（可以是 URL 或本地文件路径）
  • size: 输出尺寸（如 "2K"、"4K"）
  • version: Seedream 版本（如 "4.5"）
  • model: 完整的模型名称（高级选项）
  • api_key: API 密钥

图生图 / 参考图像（多张图像：URL 或本地文件）

uv run {baseDir}/scripts/generate_image.py \
  --prompt "将图1的服装换为图2的服装" \
  --filename "换装女孩.jpg" \
  -i "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png" \
  -i "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png" \
  --size 2K \
  --version 4.5

本地参考图像（多张本地文件）

uv run {baseDir}/scripts/generate_image.py \
  --prompt "多图融合成一张插画" \
  --filename "多图融合插画.jpg" \
  -i "/path/to/参考图1.jpg" \
  -i "/path/to/参考图2.png" \
  --size 2K \
  --version 4.5

注意事项

API 密钥
  • 你要先自动检测是否有 ARK_API_KEY 环境变量，没有需要向用户要或者让用户在火山引擎申请
版本选项
  • 4.0 → doubao-seedream-4-0-250828
  • 4.5（默认）→ doubao-seedream-4-5-251128
  • 5.0 → doubao-seedream-5-0-260128
  • 高级选项：仍可通过 --model doubao-seedream-5-0-lite-260128 等参数覆盖默认映射。
尺寸选项（按版本）
  • 4.0: 1K, 2K, 4K
  • 4.5: 2K, 4K
  • 5.0: 2K, 3K
文件名建议（供调用方参考）
  • 不要在文件名里包含 "seedream" 之类的实现细节。
  • 文件名语言应与用户 Prompt 语言保持一致，例如中文 Prompt 就用简短中文文件名（如 可爱小狗.jpg）。
  • 名字要有语义但尽量简短，避免过长句子。
关键词提示（供搜索发现）
  • "doubao", "豆包", "即梦", "Seedream", "dreamina"
  • "ByteDance image model", "字节跳动生图模型"
  • "文生图", "图生图", "参考图", "图片生成", "图像生成", "换装", "图片编辑"

Comments

Markdown supported