jimeng-generator（吉盟发电机）

即梦 4.0 图片生成器

基于火山引擎即梦 AI 4.0 生成图片。一条命令完成：提交任务 → 等待完成 → 保存图片。

配置凭证

使用前需要配置火山引擎凭证。请按以下步骤操作：

1. 前往 火山引擎控制台 → 访问控制 → 密钥管理，获取 Access Key 和 Secret Key
2. 在项目根目录创建 .env 文件，写入你的凭证：

VOLCENGINE_AK=你的AccessKey
VOLCENGINE_SK=你的SecretKey

如果使用 STS 临时凭证，改为填写 AK + Token： ``bash VOLCENGINE_AK=你的AccessKey VOLCENGINE_TOKEN=你的SecurityToken ``

项目已提供 .env.example 模板，也可以直接复制后修改：

cp .env.example .env

.env 文件已被 .gitignore 忽略，不会提交到仓库，请放心填写真实凭证。

安装

npm install

基本用法

npx ts-node scripts/generate.ts "提示词"

脚本会自动提交 → 轮询 → 保存图片到 ./output/。

完整用法

npx ts-node scripts/generate.ts "提示词" [选项]

选项

使用示例

文生图

npx ts-node scripts/generate.ts "水墨山水画"

指定尺寸

npx ts-node scripts/generate.ts "赛博朋克城市" --width 2560 --height 1440

图片编辑

npx ts-node scripts/generate.ts "背景换成星空" --images "https://example.com/photo.jpg"

多图组合

npx ts-node scripts/generate.ts "合成一张合照" --images "https://a.jpg,https://b.jpg"

强制单图 + 高影响

npx ts-node scripts/generate.ts "精细插画风格的城堡" --single --scale 0.8

输出格式

脚本结果通过 stdout 输出一行 JSON，便于解析。请用其中的 files 数组直接作为“生成结果”返回给用户（本地文件路径，可用来展示或附件），不要只贴直链或把本地路径藏在文案里。

成功时示例：

{
  "success": true,
  "taskId": "7392616336519610409",
  "prompt": "水墨山水画",
  "count": 1,
  "files": ["/path/to/output/1.png"],
  "urls": ["https://..."]
}

集成建议：解析 stdout 该行 JSON，若 success === true，则把 files 中的路径作为“已生成的图片”直接提供给用户（例如展示图片或作为附件），无需再组织成“直链在这：… 本地文件在：…”的文案。

失败时错误信息在 stderr，JSON 形如：

{
  "success": false,
  "error": { "code": "FAILED", "message": "错误描述" }
}

即梦 4.0 特性

• 智能比例：可在 prompt 中描述比例，模型自动适配最优宽高
• 多图输入：最多 10 张参考图，支持图片编辑和多图组合
• 多图输出：单次最多输出 15 张关联图片
• 4K 输出：支持从 1K 到 4K 分辨率
• 中文增强：显著提升中文生成准确率

推荐尺寸