豆包图片生成 Skill

调用火山方舟 Seedream API 生成/编辑图片，自动选择模型并限制用量。

触发词（精确匹配，不触发不调用）

工作流程

调用 doubao_image_gen.py 脚本：

1. 检测触发词 — 从用户输入提取 prompt、size、style、图生图标记
2. 模型选择 — 按 4.5 → 5.0Lite → 4.0 降级，满 18 次跳过
3. 尺寸解析 — 2K(2048²) / 4K(4096²) / 16:9 / 1920x1080 / 4K+16:9→5461×3072
4. 调用 API — POST https://ark.cn-beijing.volces.com/api/v3/images/generations
5. 保存图片 — 下载到 Image/，命名：内容分辨率-模型-时间.png
6. 记录历史 — 写入 image_gen_history.json，7 天自动清理

调用方式

from doubao_image_gen import DoubaoImageGenerator
g = DoubaoImageGenerator()

# 文生图
g.generate_text_to_image("提示词", size="2K")           # 默认 2K
g.generate_text_to_image("提示词", size="4K", ratio="16:9")  # 4K+宽屏
g.generate_text_to_image("提示词", size="1920x1080")    # 精准分辨率

# 图生图
g.generate_image_to_image("编辑指令", image_url="https://...")

# 组图
g.generate_sequence("提示词", max_images=4)

# 查看状态
g.get_status()

# 强制模型
g.generate_text_to_image("提示词", force_model="Doubao-Seedream-4.0")

尺寸

模型

每模型每日 18 次，全部超限返回 {"success":false,"error":"..."}。

配置与获取密钥

🎁 火山「协作奖励计划」：新用户注册火山方舟即可免费使用 Seedream-4.5/5.0-Lite/4.0 等顶级生图模型，无需预充值。详情见 火山方舟控制台。

1. ARK_API_KEY（必填 — 用于生成图片）

在火山方舟控制台创建 API Key：

1. 打开 https://console.volcengine.com/ark → API Key 管理
2. 点击「创建 API Key」，复制生成的 ark-xxx 字符串

export ARK_API_KEY="ark-your-key-here"

2. IAM 密钥（可选 — 用于自动同步用量）

用量同步需要火山云 IAM 密钥（Access Key + Secret Key）：

1. 打开 https://console.volcengine.com/iam → 访问控制 → 用户
2. 创建用户或选择已有用户 → 密钥管理
3. 生成 Access Key，保存 AccessKeyId 和 SecretAccessKey

export VOLCENGINE_ACCESS_KEY="AKLTxxx"
export VOLCENGINE_SECRET_KEY="your-secret"

不配 IAM 密钥也能正常生成图片，只是无法从控制台自动同步已用量。

3. 模型接入点 ID（必填 — 三个模型各需一个）

在火山方舟控制台为三个 Seedream 模型分别创建接入点：

1. 打开 https://console.volcengine.com/ark → 在线推理
2. 分别创建 Seedream-4.5、Seedream-5.0-Lite、Seedream-4.0 的接入点
3. 复制各接入点的 Model ID（如 doubao-seedream-4-5-251128）

export DOUBAO_MODEL_45_ID="doubao-seedream-4-5-251128"   # 必填
export DOUBAO_MODEL_50L_ID="doubao-seedream-5-0-260128"  # 必填
export DOUBAO_MODEL_40_ID="doubao-seedream-4-0-250828"   # 必填

文件