Image Gen CLI

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

安装

npm i @image-gen/cli -g

命令

设置 API Key

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

查看状态

image-gen status

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

生成图片

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

示例：

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

获取任务状态

image-gen get-task <taskId>

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

上传图片

image-gen upload <filePath>

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

示例：

image-gen upload ./my-image.png

移除图片背景

image-gen removebg <imageUrl>

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

示例：

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

以图生图

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

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

参数：

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

示例：

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