Jimeng Image Gen

---
name: jimeng-ai
description: >
  即梦 AI 图片生成技能（火山引擎图片生成 4.0）。当用户想要 AI 生成图片、文生图、图生图、
  字体设计、海报制作时使用。支持场景：
  - "帮我生成一张图片：..."
  - "用即梦画一张 16:9 的科技感壁纸"
  - "字体设计：新年快乐，红色背景"
  - "把这张图的背景换成星空"
  - "生成一组表情包"
  - "4K 高清图片生成"
  需要配置环境变量 JIMENG_ACCESS_KEY 和 JIMENG_SECRET_KEY（火山引擎即梦 AI）。
  API 详情见 references/api.md。
metadata:
  openclaw:
    emoji: "🎨"
    requires:
      bins:
        - node
      env:
        - JIMENG_ACCESS_KEY
        - JIMENG_SECRET_KEY
    primaryEnv: JIMENG_ACCESS_KEY
---

# 即梦 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](references/api.md)，包含完整参数表、错误码、计费说明。