imgen - Azure OpenAI Image Generation CLI

How to Run

imgen is NOT globally installed. Use one of these methods:

# 開発モード（ソースから直接実行、.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 と表記するが、実際は上記いずれかの方法で実行すること。

Quick Reference

imgen image gen "<prompt>" -q <quality> -s <size>    # 画像生成
imgen image edit <file> "<instruction>"               # 画像編集
imgen image explain <file> -l <lang>                  # 画像説明

Setup

環境変数または .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

Variable	Description	Default
AZURE_OPENAI_ENDPOINT	Azure OpenAI resource endpoint	(required)
AZURE_OPENAI_API_KEY	Azure OpenAI API key	(required)
AZURE_OPENAI_DEPLOYMENT_NAME	Chat model deployment	(required)
AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE	Image model deployment	(required)
AZURE_OPENAI_API_VERSION	Chat API version	2024-02-15-preview
AZURE_OPENAI_IMAGE_API_VERSION	Image API version	2025-04-01-preview

Image Generation

imgen image gen [options] <theme>

Option	Values	Default
-s, --size	1024x1024, 1536x1024, 1024x1536	1024x1024
-q, --quality	low, medium, high	high
-f, --format	png, jpg, webp	png
-p, --preset	builtin preset name	-
-c, --context	context file path (.md/.txt)	-
-o, --output	output path (file or directory)	auto
-d, --debug	enable debug logging	false
--json	JSON output format	false
--dry-run	preview settings without API call	false

Recommended Settings

Use Case	Quality	Size
Product photo, landscape	high	1536x1024
Illustration, icon, mascot	high	1024x1024
Quick draft, prototype	low	1024x1024
Portrait, vertical	high	1024x1536

Examples

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

Image Editing

imgen image edit [options] <file> <prompt>

Edit instructions in natural language:

• Background change: "背景を青空に変更"
• Style transfer: "水彩画風に変換"
• Object modification: "色を鮮やかに"

Supported input formats: .jpg, .jpeg, .png, .gif, .webp

Option	Values	Default
-s, --size	1024x1024, 1536x1024, 1024x1536	1024x1024
-f, --format	png, jpg, webp	png
-o, --output	output path	auto
--json	JSON output format	false
--dry-run	preview settings without API call	false

Examples

imgen image edit photo.jpg "背景を青空に変更"
imgen image edit portrait.png "アニメスタイルに変換" -s 1536x1024
imgen image edit photo.png "edit" --dry-run

Image Explanation

imgen image explain [options] <file>

Option	Values	Default
-l, --lang	ja, en, zh, ko, es, fr, de, it, ru, vi	ja
-f, --format	markdown, json	markdown
-c, --context	context info (text or .md/.txt file path)	-
-o, --output	output file path	stdout

Examples

imgen image explain screenshot.png
imgen image explain photo.jpg -l en
imgen image explain chart.png -c "Q4 sales report" -f json

Builtin Presets

-p オプションで指定可能:

Name	Size	Quality
builtin:square	1024x1024	high
builtin:landscape	1536x1024	high
builtin:portrait	1024x1536	high
builtin:draft	1024x1024	low
builtin:photo	1536x1024	high

Option Priority

CLI options > Preset values (-p) > Default values