调用火山方舟 Seedream API 文档 生成/编辑图片,自动选择模型并限制用量。参与火山协作奖励计划免费使用顶级生图模型。
> ⚠️ 配置只需一次! 如果 .env 文件已存在且包含 ARK_API_KEY 和 3 个模型 ID,说明已配置过,直接跳到"调用方式"执行命令,不要重新配置。
在同一个控制台,左侧菜单 → 在线推理 → 创建推理接入点,选以下 3 个模型:
| 环境变量名 | 模型 | 说明 |
|---|---|---|
| ----------- | ------ | ------ |
DOUBAO_MODEL_45_ID | Seedream-4.5 | 主力模型,所有模式优先 |
DOUBAO_MODEL_50L_ID | Seedream-5.0-Lite | 轻量备选 |
DOUBAO_MODEL_40_ID | Seedream-4.0 | 仅支持文生图 |
每个接入点创建后会得到一个 ep-xxxxx 格式的 ID,复制保存。
在 Skill 目录下创建 .env 文件,填入你的 Key 和接入点 ID:
ARK_API_KEY=你的API Key
DOUBAO_MODEL_45_ID=ep-xxxxx
DOUBAO_MODEL_50L_ID=ep-xxxxx
DOUBAO_MODEL_40_ID=ep-xxxxx
> 可选:加上 IAM 密钥可自动同步控制台用量
> ```bash
> VOLCENGINE_ACCESS_KEY=你的Access Key
> VOLCENGINE_SECRET_KEY=你的Secret Key
> ```
python doubao_image_gen.py --help
不报错,就配置好了。
> 这是操作手册,不是参考文档。检测到触发词后,直接复制对应命令执行,禁止只回复文字。
确认 Skill 目录后,先 cd 进去,再执行对应命令。Skill 安装在: .openclaw/workspace/skills/bytedance-ai-image-gen/
执行成功后,脚本会输出 ✅ 生成成功! 及本地文件路径。你必须把文件路径告知用户。
⚠️ 严禁: 只回复"正在生成..."而不执行命令。必须跑 python doubao_image_gen.py ...。
| 命令 | 用途 | 示例 |
|---|---|---|
| ------ | ------ | ------ |
gen "描述" [尺寸] [--ratio 比例] | 文生图 | gen "洪崖洞夜景" 4K --ratio 16:9 |
img2img "描述" "图片" [尺寸] | 图生图 | img2img "换成夜景" "photo.jpg" 4K |
seq "描述" [--num 数量] | 组图 | seq "猫咪" --num 3 |
seq "描述" --refs img1 img2 | 多图融合 | seq "融合" --refs a.jpg b.jpg |
sync | 同步控制台用量 |
| 参数 | 说明 |
|---|---|
| ------ | ------ |
尺寸 | 3K(默认) / 4K(高清) / 自定义 |
--ratio | 16:9(宽屏) / 9:16(竖屏) / 21:9(电影) |
--no-watermark | 去水印 |
--num | 组图数量 |
3K4K3K --ratio 16:93K --ratio 9:164K --ratio 21:94.5 / 5l / 4.0.env 设 DEFAULT_WATERMARK=false 永久关闭--no-watermark总结:触发 → 推断参数 → 直接执行。中间不要有任何回合的确认。
genimg2imgseq --refs共 7 个版本