- name
- jimeng-ai
- description
- >
- metadata
- openclaw
- emoji
- 🎨
- requires
- bins
- env
- primaryEnv
- JIMENG_ACCESS_KEY
即梦 AI 图片生成（4.0）
基于火山引擎即梦 AI 图片生成 4.0 异步接口，纯 Node.js 内置模块，零依赖。
快速使用
# 文生图（2K 自动比例）
node {baseDir}/scripts/jimeng.mjs generate --prompt "赛博朋克城市夜景，霓虹灯，雨天"
# 指定比例
node {baseDir}/scripts/jimeng.mjs generate --prompt "山水画，中国风" --ratio 16:9
# 4K 高清
node {baseDir}/scripts/jimeng.mjs generate --prompt "星空下的雪山" --ratio 16:9-4k --save ./output.png
# 字体设计模式
node {baseDir}/scripts/jimeng.mjs generate --text "618大促" --color 橙色 --illustration "购物车,礼盒,星星" --ratio 4:3
# 图生图（换背景）
node {baseDir}/scripts/jimeng.mjs generate --prompt "把背景换成星空" --image-url "https://..." --scale 0.7
# 强制单图（快速省钱）
node {baseDir}/scripts/jimeng.mjs generate --prompt "一只猫" --force-single --save ./cat.png
# 查看比例预设
node {baseDir}/scripts/jimeng.mjs ratios
参数说明
提示词（二选一）
| 参数 | 说明 |
|---|
--prompt | 通用文生图提示词，中英文均可，最长 800 字符 |
--text | 字体设计模式：图片上显示的文字 |
--color | 字体设计模式：背景主色调（默认: 蓝色） |
--illustration | 字体设计模式：配饰元素，逗号分隔 |
分辨率（三选一，不传默认 2K 自动比例）
| 参数 | 说明 |
|---|
--ratio | 比例预设（见 ratios 命令），如 16:9、4:3、1:1、16:9-4k |
--width + --height | 精确宽高（需同时传） |
--size | 像素面积，如 4194304（2K）、16777216（4K） |
图生图
| 参数 | 说明 |
|---|
--image-url | 参考图 URL，多张用逗号分隔，最多 10 张 |
--scale | 文本影响强度 0~1（0=完全参考图，1=完全按提示词，默认 0.5） |
其他
| 参数 | 说明 |
|---|
--force-single | 强制只生成 1 张（省钱省时，避免 AI 自动多图计费） |
--save <路径> | 保存图片到本地，多图自动加序号 |
注意事项
- 计费：按输出图片张数计费，AI 默认可能输出多张；对费用敏感时加
--force-single - 图片 URL 有效期：24 小时，需及时下载
- 任务超时：最长等待 120 秒，超时后可用 task_id 手动查询
- 内容审核：提示词含敏感词会被拦截（code 50412/50413），修改提示词后重试
API 详情
见 references/api.md，包含完整参数表、错误码、计费说明。
