开源 CLI 工具 etch 发布：一条命令调用 OpenAI、Gemini、FLUX 生成和编辑图片

用于通过主流服务商生成和编辑图像的可脚本化 CLI 工具，支持 OpenAI、Gemini 和 FLUX。

npm install -g etch-image etch "a polished app icon for a CLI image generation tool called etch"

你需要为你打算使用的服务商准备 API key，放在 ~/.config/etch/.env 中。详见「安装配置」一节。

服务商 模型 OpenAI gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5 gpt-image-1 gpt-image-1-mini Gemini gemini-nano-banana-2.1 gemini-3.1-flash-image gemini-3.1-flash-lite-image gemini-3-pro-image gemini-2.5-flash-image FLUX（Black Forest Labs） flux-3-image flux-3-image-klein flux-2-pro flux-2-max flux-2-flex flux-2-klein-9b flux-2-klein-4b flux-2-pro-preview flux-kontext-pro flux-kontext-max flux-pro-1.1 flux-pro-1.1-ultra flux-dev

安装配置 npm install -g etch-image

Etch 采用自带 token 的方式。你需要为自己要用的服务商提供 API key，放在 ~/.config/etch/.env 中：

OPENAI_API_KEY=your_key_here GEMINI_API_KEY=your_key_here BFL_API_KEY=your_key_here

只需要为你计划使用的服务商配置 key。程序会先读取 shell 环境变量，再读取 ~/.config/etch/.env。

etch [input_file ...] "prompt" [options]

最后一个位置参数始终是提示词。它前面的内容都会被当作输入图像。

结果会保存为 PNG。用 -o <path> 指定文件路径；不指定的话，Etch 会自动生成文件名，并输出到当前目录（或配置中的 output_dir）。

参数 说明 -o, --output <path> 图像保存位置（默认：当前目录下自动命名的 PNG）。除非指定 --force，否则绝不覆盖已有文件 -n, --count <n> 生成图像的数量，1 到 10（默认：1）。配合 -o 使用时，文件名会附加 -1、-2……后缀 --model <model> 要使用的模型（默认：gpt-image-2.5-sunburst） --size <size> 输出尺寸；取决于服务商，详见「尺寸与质量」 --quality <quality> 质量等级（OpenAI）或分辨率档位（FLUX 3），详见「尺寸与质量」 --background <background> 背景样式（仅 OpenAI） --open 保存后打开图像（在终端中运行时为默认行为） --dont-open 保存后不打开图像 --json 以 JSON 对象形式输出结果，而非文本 --force 若输出文件已存在则覆盖 --models 列出可用模型并退出 --sizes 按服务商列出可用尺寸并退出 --config 显示配置文件路径和实际生效的默认值，然后退出

尺寸与质量

--size 和 --quality 接受哪些值取决于模型。运行 etch --sizes 可查看列表。

任何选项的默认值都可以在 ~/.config/etch/config.json 中修改（如果设置了 $XDG_CONFIG_HOME，则为 $XDG_CONFIG_HOME/etch/config.json）。命令行上的参数始终优先于配置文件。

"open": false, "model": "gpt-image-2.5-flare