mcpField
G
generate-image-by-seedream

generate-image-by-seedream

github.com/chunpu创意与媒体3988 次安装30 周前更新
代码仓库

关于 generate-image-by-seedream

该技能通过脚本调用字节跳动 Seedream 模型生成或编辑图片，面向需要文生图、图生图和多图参考处理的创作者。可用命令行或 YAML 指定提示词、参考图、尺寸和版本。

主要功能

  1. 01支持文生图与图生图
  2. 02接受 URL 和本地参考图
  3. 03通过 YAML 配置生成参数
  4. 04设置模型版本与输出尺寸
  5. 05支持命令行参数覆盖配置

适用场景

  1. 01根据文字描述生成图片
  2. 02用参考图编辑或融合图像
  3. 03批量复用 YAML 生图设置

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/generate-image-by-seedream确认已加载。

附带文件README.mdscripts/generate_image.py

详细介绍

来自项目 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", "字节跳动生图模型"
  • "文生图", "图生图", "参考图", "图片生成", "图像生成", "换装", "图片编辑"

评论

支持 Markdown