关于 imgen
imgen 是一款通过 Azure OpenAI 生成、编辑和说明图像的命令行工具，支持配置输出参数、使用预设以及预览设置。
主要功能
- 01按尺寸和质量生成图像
- 02用自然语言指令编辑图像
- 03以多种语言说明图像
- 04使用内置预设和上下文文件
- 05通过 dry-run 预览设置
适用场景
- 01制作插画、产品照片或草稿
- 02更改图像背景或风格
- 03获取截图或图表的说明
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/imgen确认已加载。
详细介绍
imgen - Azure OpenAI 图像生成命令行工具
运行方式
imgen 未进行全局安装。请使用以下任一方法：
# 開発モード（ソースから直接実行、.envを自動読み込み）
npm run dev --prefix /Volumes/Data/dev/imgen -- <command>
# npx でソースから実行（.envは自動読み込みされない）
npx tsx /Volumes/Data/dev/imgen/src/index.ts <command>
# npm パッケージとして実行（npm install -g @nogataka/imgen 済みの場合）
imgen <command>
以下示例中均使用 imgen 表示，但实际运行时请使用上述任一方法。
快速参考
imgen image gen "<prompt>" -q <quality> -s <size> # 画像生成
imgen image edit <file> "<instruction>" # 画像編集
imgen image explain <file> -l <lang> # 画像説明
设置
通过环境变量或 .env 文件设置 Azure OpenAI 身份验证信息。
# 環境変数（最優先）
export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com"
export AZURE_OPENAI_API_KEY="your-api-key"
export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-5.1"
export AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE="gpt-image-1.5"
.env 文件搜索顺序：cwd/.env → ~/.imgen/.env
| 变量 | 说明 | 默认值 |
|---|---|---|
AZURE_OPENAI_ENDPOINT | Azure OpenAI 资源终结点 | （必填） |
AZURE_OPENAI_API_KEY | Azure OpenAI API 密钥 | （必填） |
AZURE_OPENAI_DEPLOYMENT_NAME | 聊天模型部署 | （必填） |
AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE | 图像模型部署 | （必填） |
AZURE_OPENAI_API_VERSION | 聊天 API 版本 | 2024-02-15-preview |
AZURE_OPENAI_IMAGE_API_VERSION | 图像 API 版本 | 2025-04-01-preview |
图像生成
imgen image gen [options] <theme>
| 选项 | 取值 | 默认值 |
|---|---|---|
-s, --size | 1024x1024、1536x1024、1024x1536 | 1024x1024 |
-q, --quality | low、medium、high | high |
-f, --format | png、jpg、webp | png |
-p, --preset | 内置预设名称 | - |
-c, --context | 上下文文件路径（.md/.txt） | - |
-o, --output | 输出路径（文件或目录） | auto |
-d, --debug | 启用调试日志 | false |
--json | JSON 输出格式 | false |
--dry-run | 不调用 API，预览设置 | false |
推荐设置
| 使用场景 | 质量 | 尺寸 |
|---|---|---|
| 产品照片、横向 | high | 1536x1024 |
| 插图、图标、吉祥物 | high | 1024x1024 |
| 快速草稿、原型 | low | 1024x1024 |
| 肖像、纵向 | high | 1024x1536 |
示例
imgen image gen "夕日の海辺の風景" -q high -s 1536x1024
imgen image gen "可愛い猫のマスコット" -p builtin:square
imgen image gen "ミニマルなロゴデザイン" -o logo.png
imgen image gen "complex scene" --dry-run
图像编辑
imgen image edit [options] <file> <prompt>
使用自然语言编写编辑说明：
- 更改背景：“将背景改为蓝天”
- 风格迁移：“转换为水彩画风格”
- 修改对象：“让颜色更鲜艳”
支持的输入格式：.jpg、.jpeg、.png、.gif、.webp
| 选项 | 取值 | 默认值 |
|---|---|---|
-s, --size | 1024x1024、1536x1024、1024x1536 | 1024x1024 |
-f, --format | png、jpg、webp | png |
-o, --output | 输出路径 | auto |
--json | JSON 输出格式 | false |
--dry-run | 不调用 API，预览设置 | false |
示例
imgen image edit photo.jpg "背景を青空に変更"
imgen image edit portrait.png "アニメスタイルに変換" -s 1536x1024
imgen image edit photo.png "edit" --dry-run
图像说明
imgen image explain [options] <file>
| 选项 | 取值 | 默认值 |
|---|---|---|
-l, --lang | ja、en、zh、ko、es、fr、de、it、ru、vi | ja |
-f, --format | markdown、json | markdown |
-c, --context | 上下文信息（文本或 .md/.txt 文件路径） | - |
-o, --output | 输出文件路径 | stdout |
示例
imgen image explain screenshot.png
imgen image explain photo.jpg -l en
imgen image explain chart.png -c "Q4 sales report" -f json
内置预设
可通过 -p 选项指定：
| 名称 | 尺寸 | 质量 |
|---|---|---|
builtin:square | 1024x1024 | high |
builtin:landscape | 1536x1024 | high |
builtin:portrait | 1024x1536 | high |
builtin:draft | 1024x1024 | low |
builtin:photo | 1536x1024 | high |
选项优先级
CLI 选项 > 预设值（-p）> 默认值
评论
支持 Markdown