mcpField
G
generate-image-by-seedream

generate-image-by-seedream

github.com/chunpuクリエイティブ・メディア3988 回インストール30 週間前に更新
リポジトリ

generate-image-by-seedream について

スクリプトから ByteDance Seedream モデルを呼び出し、画像の生成や編集を行うスキルです。テキストからの生成、画像からの編集、複数の参照画像に対応し、CLI 引数または YAML で設定できます。

主な機能

  1. 01テキスト・画像からの生成
  2. 02URL とローカル参照画像の利用
  3. 03YAML による生成設定
  4. 04モデルバージョンと出力サイズの指定
  5. 05CLI 引数による設定上書き

活用シーン

  1. 01テキストの説明から画像を生成
  2. 02参照画像を使った編集や合成
  3. 03YAML 設定を再利用した画像生成

インストール

コマンドをコピーしてターミナルで実行します。

$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 対応