ByteDance AI 图片生成 — 豆包/ByteDance Seedream
调用火山方舟 Seedream API 生成/编辑图片，自动选择模型并限制用量。
行为规则（最高优先级 — 必须遵守！）
以下行为严格禁止，违反任一即为 Bug：
永远不要问"这将消耗 1 次配额，是否继续？""今天还剩 X 次，确定要用吗？"之类的问题
用户调用 Skill 即表示知情并同意消耗配额，直接执行，一个字都别问
永远不要问"用 2K 还是 4K？""什么比例？""分辨率要多大？"之类的问题
按以下规则自动推断并直接执行，不询问：
用户没提尺寸 → 用 2K (2048×2048)
提示词含"4K""高清""超清""极致" → 用 4K (4096×4096)
提示词含"宽屏""横版""16:9""电影" → 用 4K + ratio="16:9"
提示词含"竖版""9:16""手机壁纸" → 用 4K + ratio="9:16"
用户明确写了尺寸 → 按指定尺寸
图生图不指定尺寸 → 自动检测参考图分辨率
永远不要问"要现在执行吗？""确认生成吗？""准备好了，要开始吗？"
触发即执行，不要等用户二次确认
总结：触发 → 推断参数 → 直接执行。中间不要有任何回合的确认。
触发词（精确匹配，不触发不调用）
触发词 例子
/img /image /draw /gen /generate /pic /img 一只猫
生成图片
画一张图
创建图片
制作图片
生成图片 海边落日 4K
图生图 img2img image to image edit this image
图生图 换背景 url
极致生成:
快速草稿:
艺术风格:
极致生成:
赛博朋克城市
generate image
create image
txt2img generate image a cat 2K
画图
帮我画
帮我生成
我想生成
搞个图
来张图
帮我画一只柴犬
please generate
please draw
I want to generate
please draw a sunset
融合 合成
两张图片
多张图片
拼合 合图
融合这两张图
blend fuse merge combine composite
blend these images
工作流程
调用 doubao_image_gen.py 脚本：
检测触发词 — 从用户输入提取 prompt、size、style、图生图标记
模型选择 — 按 4.5 → 5.0Lite → 4.0 降级，满 18 次跳过
尺寸自动推断 — 不再询问用户，直接按规则确定
图片规范化 — 本地路径自动 base64 编码，URL 原样通过
调用 API — POST https://ark.cn-beijing.volces.com/api/v3/images/generations
保存图片 — 下载到 Image/，命名：内容分辨率-模型-时间.png
记录历史 — 写入 image_gen_history.json，7 天自动清理
调用方式
from doubao_image_gen import DoubaoImageGenerator
g = DoubaoImageGenerator()
# 文生图
g.generate_text_to_image("提示词")
# 默认 2K
g.generate_text_to_image("提示词", size="4K", ratio="16:9")
# 图生图（支持公网 URL / 本地路径 / base64，本地文件自动编码）
g.generate_image_to_image("编辑指令", image_url="https://...")
g.generate_image_to_image("编辑指令", image_url="C:/Users/.../photo.jpg")
# 组图 / 多图融合
g.generate_sequence("提示词", max_images=4)
g.generate_sequence("提示词", max_images=1, image_urls=["url1","url2"])
g.generate_sequence("提示词", max_images=1, image_urls=["C:/a.jpg","C:/b.jpg"])
# 查看状态
g.get_status()
尺寸 方式 写法 结果
预设 2K / 4K 2048² / 4096²
预设+比例 4K + ratio="16:9" 5461×3072
比例 16:9 1:1 4:3 21:9
推荐分辨率 精准 1920x1080 最大 16,777,216 px
模型 模型 优先级 日限
Seedream-4.5 1 18
Seedream-5.0-Lite 2 18
Seedream-4.0 3 18
超限返回 {"success":false,"error":"..."}。
配置（.env 文件）
在 Skill 目录下创建 .env 文件：
# 必填
ARK_API_KEY=ark-your-key-here
DOUBAO_MODEL_45_ID=doubao-seedream-4-5-251128
DOUBAO_MODEL_50L_ID=ep-xxxxxxxxxxxx
DOUBAO_MODEL_40_ID=doubao-seedream-4-0-250828
# 可选（控制台用量同步）
VOLCENGINE_ACCESS_KEY=AKLTxxx
VOLCENGINE_SECRET_KEY=your-secret
脚本启动时自动加载 .env，无需手动 export。
获取密钥
ARK_API_KEY: https://console.volcengine.com/ark → API Key 管理
模型 ID: https://console.volcengine.com/ark → 在线推理 → 创建接入点
IAM 密钥: https://console.volcengine.com/iam → 访问控制 → 密钥管理
文件 文件 说明
doubao_image_gen.py 核心脚本
.env 环境变量配置
openclaw.json Skill 元数据
image_gen_history.json 调用历史+计数 (7天清理)
Image/ 生成图片保存目录
by