open-index/open-npm huggingface dataset:
npm package: @image-gen/cli
Description: CLI tool for generating images
Latest version: 1.0.1

# Image Gen CLI

图片生成 CLI 工具，通过 API 接口生成图片并管理任务。

## 安装

```bash
npm i @image-gen/cli -g
```

## 命令

### 设置 API Key

```bash
image-gen set-key <your-api-key>
```

### 查看状态

```bash
image-gen status
```

显示当前 API Key 配置和用户权益信息。

### 生成图片

```bash
image-gen generate <prompt> <image_gen_type> [-s <size>]
```

**参数：**

- `<prompt>` - 图片描述文本
- `<image_gen_type>` - 文生图类型
  - `1` - 质量高，构图能力强，ai味低
  - `2` - 风格适配比较好，比如动漫、水墨风格

**选项：**

- `-s, --img-size <size>` - 图片尺寸比例，默认 `1:1`
  - 可选值：`1:1` | `16:9` | `9:16` | `4:3` | `3:4` | `3:2` | `2:3`

**示例：**

```bash
image-gen generate "一只可爱的猫咪在草地上玩耍" 1
image-gen generate "未来城市" 1 -s 16:9
image-gen generate "水墨山水画" 2 --img-size 9:16
```

### 获取任务状态

```bash
image-gen get-task <taskId>
```

根据任务 ID 查询图片生成任务的状态和结果。

### 上传图片

```bash
image-gen upload <filePath>
```

上传本地图片文件，返回文件名、文件大小、URL 和路径信息。

**示例：**

```bash
image-gen upload ./my-image.png
```

### 移除图片背景

```bash
image-gen removebg <imageUrl>
```

传入线上图片地址，调用去背景接口，返回任务 ID，可通过 `get-task` 查询结果。

**示例：**

```bash
image-gen removebg "https://example.com/my-photo.png"
```

### 以图生图

```bash
image-gen image-edit <description> <imageUrls...>
```

传入编辑描述和一张或多张线上图片地址（最多 3 张），返回任务 ID，可通过 `get-task` 查询结果。

**参数：**

- `<description>` - 图片编辑描述
- `<imageUrls...>` - 线上图片地址（支持多张，空格分隔，最多 3 张）

**示例：**

```bash
image-gen image-edit "让他大笑起来" "https://example.com/photo.png"
image-gen image-edit "合并这两张图" "https://example.com/a.png" "https://example.com/b.png"
```

## 全局配置

全局配置文件存储位置：

- **Windows**: `%APPDATA%\image-gen\config.json`
- **macOS/Linux**: `~/.config/image-gen/config.json`