open-index/open-npm huggingface dataset:
npm package: @rongyan/image-gen-cli
Description: 适配多个模型厂商的图片生成命令行工具
Author: rongyan
Latest version: 1.0.0

# @rongyan/image-gen-cli

适配多个模型厂商的图片生成命令行工具，支持 `npx` 一键运行，也支持全局安装。

## 支持的服务商

| 服务商 | 模型 | 状态 |
|--------|------|------|
| MiniMax | image-01 | ✅ 已支持 |

## 安装

### 方式一：npx 一键运行（无需安装）

```bash
npx @rongyan/image-gen-cli@latest "a beautiful sunset"
```

### 方式二：全局安装

```bash
npm install -g @rongyan/image-gen-cli@latest
```

安装后使用 `image-gen` 命令：

```bash
image-gen "a beautiful sunset"
```

## 配置

首次运行时，工具会自动检测配置文件，若未配置则提示你交互式输入 API Key：

```
⚠ 未找到 minimax 的 API Key 配置

配置 minimax API Key
配置将保存到: ~/.@rongyan/image-gen-env.json

? MiniMax API Key: **********************

✓ minimax 配置已保存
```

配置保存在 `~/.@rongyan/image-gen-env.json`：

```json
{
  "minimax": {
    "apiKey": "your-api-key-here"
  }
}
```

### 手动配置 / 更新 API Key

```bash
image-gen config

# 指定服务商
image-gen config --provider minimax
```

MiniMax API Key 获取地址：https://platform.minimaxi.com

## 使用

### 基本用法

```bash
image-gen "a cat sitting on a windowsill, watercolor style"
```

生成的图片默认保存到当前目录，文件名格式为 `image-gen-2026-03-28T12-00-00.jpg`。

### 指定输出目录

```bash
image-gen "a beautiful sunset" --output ./images
```

### 指定输出文件路径

```bash
image-gen "a beautiful sunset" --output ./images/sunset.jpg
```

### 指定宽高比

```bash
image-gen "a wide landscape" --aspect-ratio 16:9
```

支持的宽高比：`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`

### 指定模型

```bash
image-gen "a portrait" --model image-01
```

### 完整参数说明

```
Usage: image-gen [options] [command] [prompt]

Arguments:
  prompt                      图片描述文字

Options:
  -V, --version               版本号
  -p, --provider <provider>   图片生成服务商 (default: "minimax")
  -o, --output <path>         输出路径（目录或完整文件路径）
  -r, --aspect-ratio <ratio>  宽高比 (default: "1:1")
  -m, --model <model>         模型名称
  -h, --help                  显示帮助

Commands:
  config [options]            配置 API Key
```

## 示例

```bash
# 生成头像（1:1）
image-gen "a professional headshot of a young engineer"

# 生成壁纸（16:9）
image-gen "futuristic city at night, cyberpunk style" -r 16:9 -o ./wallpapers

# 生成手机壁纸（9:16）
image-gen "cherry blossom forest, anime style" -r 9:16 -o ~/Pictures/phone-wallpaper.jpg

# 使用 npx 生成并保存到指定目录
npx @rongyan/image-gen-cli "a cozy coffee shop" -o ./output
```

## 系统要求

- Node.js >= 18.0.0