即梦AI 图片生成 4.6

通过火山引擎视觉智能平台 (Visual Intelligence) 生成高质量 AI 图片。

前置条件

使用前需设置两个环境变量：

VOLC_ACCESS_KEY=your-ak-here
VOLC_SECRET_KEY=your-sk-here

获取 AK/SK：https://console.volcengine.com/iam/keymanage

开通服务：https://console.volcengine.com/ai/ability/info/104

可选配置：

• JIMENG_REQ_KEY — 切换模型版本 (默认 jimeng_seedream46_cvtob)
• JIMENG_POLL_MAX — 最大轮询次数 (默认 60)
• JIMENG_POLL_MS — 轮询间隔毫秒 (默认 2000)
• JIMENG_RETRY_MAX — 最大重试次数 (默认 3，指数退避)
• JIMENG_RETRY_MS — 重试基础间隔毫秒 (默认 1000)

核心脚本

node scripts/jimeng.mjs <command> [选项]

命令

| 命令 | 用途 |

|------|------|

| text2img | 文生图 — 文字描述生成图片 |

| img2img | 图生图 — 参考图+提示词生成新图 |

| result | 查询任务结果 |

| download | 下载图片到本地 |

| status | 检查配置状态 |

文生图参数

| 参数 | 短参数 | 说明 |

|------|--------|------|

| --prompt | -p | 必需 — 图片描述文本 |

| --size | -s | 尺寸预设或 WxH (默认模型智能判断) |

| --scale | | 文本影响程度 1-100 (默认 50) |

| --single | | 强制只生成单图 |

| --no-url | | 返回 base64 而非 URL |

| --async | -A | 仅提交不轮询，返回 task_id |

图生图额外参数

| 参数 | 短参数 | 说明 |

|------|--------|------|

| --image-url | -i | 必需 — 参考图 URL |

| --scale | | 文本影响程度 1-100 (默认 50) |

尺寸预设

1:1 / 3:4 / 4:3 / 9:16 / 16:9 / 2:3 / 3:2 / 21:9 / 1k / 2k / 4k

也支持自定义 WxH 格式，如 2560x1440。

工作流程

文生图 (text2img)

1. 使用 node scripts/jimeng.mjs text2img -p "提示词" [选项] 提交任务
2. 脚本自动轮询直到完成（约 5-60s）
3. 获取图片 URL，如需本地保存使用 download 命令

示例：

# 简单生成
node scripts/jimeng.mjs text2img -p "赛博朋克城市夜景,霓虹灯光"

# 指定所有参数
node scripts/jimeng.mjs text2img \
  -p "一只穿西装的猫在咖啡馆喝咖啡,吉卜力风格" \
  -s "16:9" \
  --scale 60

图生图 (img2img)

1. 先将本地图片上传到可访问的 URL (如 TOS、图床等)
2. 使用 node scripts/jimeng.mjs img2img -p "提示词" -i "图片URL" [选项]
3. 脚本自动轮询直到完成

示例：

node scripts/jimeng.mjs img2img \
  -p "添加梵高星月夜风格,油画质感" \
  -i "https://example.com/my-photo.jpg" \
  --scale 70

AI Agent 对话示例

在聊天中直接告诉 AI 你的需求，无需手动执行命令行：

用户: 帮我生成一张赛博朋克风格的猫咪图片，16:9 尺寸
AI: [自动执行文本生图 → 轮询等待 → 返回图片链接]

用户: 把这张照片改成吉卜力动画风格
AI: [先让你提供图片URL → 执行图生图 → 返回新图]

用户: 帮我查一下刚才那个任务的进度
AI: [用 task_id 查询 → 返回当前状态]

API 参考

详细的 API 参数、响应格式、错误码见：references/api_reference.md

常见问题

配置报错、网络超时、尺寸选择等问题，见：FAQ.md

与其他 Skill 配合

• 生成配图后可使用 cloud-upload-backup skill 上传到云端
• 生成的图片可作为 docx skill 的文档插图
• 可使用 canvas-design skill 对生成的图进行二次设计

注意事项

• AK/SK 安全：不要在对话中直接粘贴 AK/SK，引导用户通过环境变量设置
• 自动重试：网络波动和服务繁忙时会自动重试（指数退避），认证/参数错误不重试
• 运行路径：脚本需从 skill 目录运行，或使用绝对路径
• 耗时：单张图片生成通常 10-60 秒，2k/4k 尺寸可能更久
• 费用：注意查看账户余额，避免超额
• 模型切换：如 4.6 不可用，设 JIMENG_REQ_KEY=jimeng_t2i_v40 回退到即梦AI 4.0
• 问题排查：遇到错误先看 FAQ.md，有各类错误的解决方案