即梦 AI 图片生成（4.0）#

基于火山引擎 即梦 AI 图片生成 4.0 异步接口，纯 Node.js 内置模块，零依赖。

快速使用#

bash

# 文生图（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，包含完整参数表、错误码、计费说明。