jimeng-image

name	jimeng-image
description	使用火山引擎 Ark 上的即梦 / Doubao Seedream 生成图片。支持文生图、图生图、多参考图、连续组图、批量模式与 workflow 模式。
version	1.0.0
author	Hermes Agent
license	MIT
platforms	["linux","macos"]
metadata	{"hermes":{"tags":["image-generation","jimeng","seedream","volcengine","ark","doubao"]}}

Jimeng Image

当用户想要：

• 用更便宜的即梦 / Seedream 替代 Nano Banana 2
• 直接调用火山引擎 Ark 生图
• 做文生图、图生图、多参考图生成
• 一次生成一组连贯图片
• 批量跑多个 prompt

就用这个 skill。

默认配置

• API：https://ark.cn-beijing.volces.com/api/v3/images/generations
• 默认模型：doubao-seedream-5-0-260128
• 认证：VOLCENGINE_API_KEY（也兼容 SEEDREAM_API_KEY / JIMENG_API_KEY）

支持能力

• 文生图单张
• 文生图一组图（sequential_image_generation=auto）
• 图生图单张
• 多参考图生成单张图
• 批量 prompt
• workflow 目录化输出

当前 v1 边界

• 参考图输入当前只支持 URL
• 暂不直接接受本地文件路径作为参考图输入
• 输出会自动下载到本地，不只返回 URL

统一入口

公开仓库建议使用：

python3 scripts/run.py --mode single --prompt '一张极具视觉冲击力的海报，黑洞，破碎列车，16:9'

推荐命令

文生图单张

python3 scripts/run.py \
  --mode single \
  --prompt '星际穿越，黑洞里冲出一辆快支离破碎的复古列车，电影大片，动感，对比色，光线追踪，动态模糊，景深，16:9' \
  --size 2k \
  --output ./outputs/train.jpg

文生图组图

python3 scripts/run.py \
  --mode single \
  --prompt '生成一组共4张连贯插画，核心为同一庭院一角的四季变迁，以统一风格展现四季独特色彩、元素与氛围' \
  --sequential auto \
  --max-images 4 \
  --outdir ./outputs/four-seasons

图生图

python3 scripts/run.py \
  --mode single \
  --prompt '生成狗狗趴在草地上的近景画面' \
  --image 'https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png' \
  --output ./outputs/dog.jpg

多参考图生成

python3 scripts/run.py \
  --mode single \
  --prompt '将图1的服装换为图2的服装' \
  --image 'https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png' \
  --image 'https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_2.png' \
  --output ./outputs/outfit-swap.jpg

已验证事实

• 当前 API 接受的 size 是：
  • 2k
  • 3k
  • WIDTHxHEIGHT
• 文生图单张、图生图单张、连续 2 图都已真实跑通
• 返回结构里 data 是数组，每个元素至少包含：
  • url
  • size
• usage.generated_images 和 usage.total_tokens 可用于记录成本信息

验证建议

先跑：

bash scripts/smoke-test.sh

再跑最小真实请求：

python3 scripts/run.py \
  --mode single \
  --prompt '一只黑白配色的几何风格小猫头像，简洁，纯色背景' \
  --size 2k