Seedream 图片生成
基于火山引擎方舟大模型服务平台的 Seedream 图片生成 API。
功能
-
✅ 文生图 (Text to Image)
-
✅ 图生图 (Image to Image) - 单图输入
-
✅ 多图融合 (Multi-image to Image) - 多图输入
-
✅ 组图生成 (Sequential Image Generation)
-
✅ 联网搜索 (Web Search) - 仅 5.0 lite
前置要求
-
Python 3.9+
-
火山引擎 API Key (ARK_API_KEY)
-
volcengine-python-sdk: pip3 install volcengine-python-sdk[ark]
环境配置
使用前需要设置环境变量 ARK_API_KEY :
export ARK_API_KEY="your-api-key-here"
使用方式
直接告诉 AI
只需告诉 AI 你想生成什么图片,例如:
-
"帮我生成一只可爱的橘猫图片"
-
"生成一张科技感的城市夜景"
-
"制作一张北京天气预报图"
AI 会自动调用 Seedream API 生成图片。
命令行使用
文生图
python3 .claude/skills/seedream/scripts/seedream.py -p "一只可爱的橘猫"
图生图
python3 .claude/skills/seedream/scripts/seedream.py -p "将图片转为水彩画风格" -i "input.png"
组图生成
python3 .claude/skills/seedream/scripts/seedream.py -p "生成4张连贯的四季风景" --sequential --max-images 4
命令行参数
参数 简写 说明 默认值
--api-key -k API Key 环境变量 ARK_API_KEY
--prompt -p 提示词 (必填)
--model -m 模型 (5.0-lite/4.5/4.0) 5.0-lite
--image -i 输入图片 URL (可多次使用)
--size -s 图像尺寸 2K
--output-format -f 输出格式 (png/jpeg) png
--watermark -w 添加水印 False
--sequential
启用组图模式 False
--max-images
最大图片数 4
--web-search
启用联网搜索 False
--output -o 输出目录 ~/Downloads
支持的模型
模型 别名 支持功能
Seedream 5.0 lite 5.0-lite 文生图、图生图、组图、联网搜索、png输出
Seedream 4.5 4.5 文生图、图生图、组图、jpeg输出
Seedream 4.0 4.0 文生图、图生图、组图、jpeg输出
图像尺寸
-
方式1: 2K , 3K , 4K (5.0-lite/4.5), 1K , 2K , 4K (4.0)
-
方式2: 像素值,如 2048x2048 , 2848x1600
获取 API Key
-
访问火山引擎控制台
-
创建 API Key
-
开通 Seedream 模型服务
安装依赖
pip3 install volcengine-python-sdk[ark]
示例
生成单张图片
文生图 - 5.0 lite
python3 .claude/skills/seedream/scripts/seedream.py -p "科技感的城市夜景"
图生图
python3 .claude/skills/seedream/scripts/seedream.py -p "转为黑白风格" -i "input.png"
使用 4.5 模型
python3 .claude/skills/seedream/scripts/seedream.py -p "可爱的柴犬" -m 4.5
生成组图
文生组图
python3 .claude/skills/seedream/scripts/seedream.py -p "生成4张连贯的四季风景" --sequential
参考图生组图
python3 .claude/skills/seedream/scripts/seedream.py -p "参考logo生成品牌设计" -i "logo.png" --sequential --max-images 6
联网搜索
生成实时天气图
python3 .claude/skills/seedream/scripts/seedream.py -p "北京今日天气预报,现代扁平化风格" --web-search
输出
-
生成的图片保存在指定输出目录 (默认 ~/Downloads)
-
文件名格式: seedream_{timestamp}_{index}.{ext}
版本历史
1.0.0
-
初始版本
-
支持文生图、图生图、多图融合、组图生成
-
支持 Seedream 5.0 lite / 4.5 / 4.0 模型
-
支持联网搜索功能