jimeng-generator

# 即梦 4.0 图片生成器

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

## 配置凭证

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

1. 前往 [火山引擎控制台](https://console.volcengine.com/) → 访问控制 → 密钥管理，获取 Access Key 和 Secret Key
2. 在项目根目录创建 `.env` 文件，写入你的凭证：

```bash
VOLCENGINE_AK=你的AccessKey
VOLCENGINE_SK=你的SecretKey
```

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

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

```bash
cp .env.example .env
```

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

## 安装

```bash
npm install
```

## 基本用法

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

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

## 完整用法

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

### 选项

| 选项 | 说明 | 默认值 |
|------|------|--------|
| `--images <url,...>` | 参考图片 URL，逗号分隔，最多 10 张 | — |
| `--width <n>` | 输出宽度 | 自动 |
| `--height <n>` | 输出高度 | 自动 |
| `--size <n>` | 输出面积 | 自动 |
| `--scale <0-1>` | 文本影响程度 | 0.5 |
| `--single` | 强制单图输出 | false |
| `--out <dir>` | 输出目录 | ./output |
| `--no-save` | 不保存，只输出 URL | false |
| `--interval <ms>` | 轮询间隔 | 3000 |
| `--timeout <ms>` | 最大等待时间 | 180000 |
| `--debug` | 调试模式 | false |

## 使用示例

### 文生图

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

### 指定尺寸

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

### 图片编辑

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

### 多图组合

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

### 强制单图 + 高影响

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

## 输出格式

脚本结果通过 **stdout** 输出一行 J...

# Jimeng Generator

Image generation powered by VolcEngine Jimeng AI 4.0.

Jimeng 4.0 combines text-to-image, image editing, and multi-image composition in a unified framework. It supports up to 10 input images, outputs up to 15 images per request, and offers smart aspect-ratio detection with 4K output.

## Setup

```bash
npm install
```

### Credentials

| Variable | Required | Description |
|----------|----------|-------------|
| `VOLCENGINE_AK` | Yes | VolcEngine Access Key |
| `VOLCENGINE_SK` | For permanent keys | VolcEngine Secret Key |
| `VOLCENGINE_TOKEN` | For STS | Security Token (temporary credentials) |

```bash
export VOLCENGINE_AK="<your-ak>"
export VOLCENGINE_SK="<your-sk>"
```

Get credentials: [VolcEngine Console](https://console.volcengine.com/) → Access Control → Key Management.

## Usage

```bash
npx ts-node scripts/generate.ts "a cute cat sitting on a windowsill"
```

The script submits the task, polls until completion, and saves images to `./output/`.

### Options

| Flag | Description | Default |
|------|-------------|---------|
| `--images <url,...>` | Reference image URLs (comma-separated, up to 10) | — |
| `--width <n>` | Output width | auto |
| `--height <n>` | Output height | auto |
| `--size <n>` | Output area (e.g. `4194304` = 2048×2048) | auto |
| `--scale <0-1>` | Text influence vs image influence | `0.5` |
| `--single` | Force single image output | `false` |
| `--out <dir>` | Output directory | `./output` |
| `--no-save` | Skip saving, print URLs only | `false` |
| `--interval <ms>` | Poll interval | `3000` |
| `--timeout <ms>` | Max wait time | `180000` |
| `--debug` | Debug logging | `false` |

### Examples

**Text-to-image with smart ratio:**

```bash
npx ts-node scripts/generate.ts "watercolor landscape, mountains and lake, 16:9"
```

**4K output:**

```bash
npx ts-node scripts/generate.ts "abstract art" --size 16777216
```

**Image editing (change background):**

```bash
npx ts-node scripts/generate.ts "change background to a co...