imgen

Azure OpenAI を使った画像生成・編集・説明 CLI ツール。gpt-image-1.5 による画像生成/編集と、gpt-5.1 によるプロンプト拡張・ファイル名生成・画像説明を提供します。

インストール

npm install -g @nogataka/imgen

セットアップ

環境変数

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"
export AZURE_OPENAI_API_VERSION="2024-02-15-preview"        # 省略可
export AZURE_OPENAI_IMAGE_API_VERSION="2025-04-01-preview"  # 省略可

.env ファイル

環境変数の代わりに .env ファイルで設定できます。探索順:

1. cwd/.env（カレントディレクトリ）
2. ~/.imgen/.env

# .env
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_API_KEY=your-api-key
AZURE_OPENAI_DEPLOYMENT_NAME=gpt-5.1
AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE=gpt-image-1.5

環境変数が設定されている場合、環境変数が優先されます。

使い方

画像生成

テキストから画像を生成します。プロンプトは gpt-5.1 で自動拡張されます。

imgen image gen "夕日の海辺の風景"
imgen image gen "可愛い猫のマスコット" -s 1536x1024 -q high
imgen image gen "ミニマルなロゴ" -c context.md -o logo.png
imgen image gen "商品写真" -p builtin:landscape

オプション	短縮	説明	デフォルト
--size <size>	-s	1024x1024, 1536x1024, 1024x1536	1024x1024
--quality <quality>	-q	low, medium, high	high
--format <format>	-f	png, jpg, webp	png
--preset <name>	-p	プリセット名	-
--context <path>	-c	コンテキストファイル (.md/.txt)	-
--output <path>	-o	出力先ファイルまたはディレクトリ	カレントディレクトリ
--json		JSON 形式で出力	-
--dry-run		API を呼ばずに設定を確認	-
--debug	-d	デバッグ情報を表示	-

画像編集

既存の画像を自然言語の指示で AI 編集します。

imgen image edit photo.jpg "背景を青空に変更"
imgen image edit portrait.png "アニメスタイルに変換" -s 1536x1024
imgen image edit image.png "色を鮮やかに" -o edited/

対応入力形式: .jpg, .jpeg, .png, .gif, .webp

オプション	短縮	説明	デフォルト
--size <size>	-s	出力サイズ	1024x1024
--format <format>	-f	png, jpg, webp	png
--output <path>	-o	出力先	カレントディレクトリ
--json		JSON 形式で出力	-
--dry-run		設定確認のみ	-

画像説明

画像の内容を指定した言語で説明します。

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

オプション	短縮	説明	デフォルト
--lang <lang>	-l	出力言語（下記参照）	ja
--format <format>	-f	markdown, json	markdown
--context <text>	-c	コンテキスト（テキストまたはファイルパス）	-
--output <path>	-o	出力ファイル（省略時は標準出力）	-

対応言語: ja(日本語), en(英語), zh(中国語), ko(韓国語), es(スペイン語), fr(フランス語), de(ドイツ語), it(イタリア語), ru(ロシア語), vi(ベトナム語)

ビルトインプリセット

名前	サイズ	品質	用途
builtin:square	1024x1024	high	正方形、アイコン
builtin:landscape	1536x1024	high	横長、風景
builtin:portrait	1024x1536	high	縦長、ポートレート
builtin:draft	1024x1024	low	下書き、プロトタイプ
builtin:photo	1536x1024	high	商品写真

設定の優先順位

1. CLI オプション（最優先）
2. プリセット値（-p 指定時）
3. デフォルト値

SDK として使う

imgen は CLI だけでなく、Node.js ライブラリとしても利用できます。スライドジェネレーターや LLM ツールなど、他のアプリケーションから画像生成・編集・説明機能を呼び出せます。

npm install @nogataka/imgen

認証設定

getAzureConfig() は以下の優先順位で設定を解決します：

1. 環境変数（最優先）
2. .env ファイル（cwd/.env → ~/.imgen/.env）

アプリ側で .env ファイルを読み込んでいる場合（dotenv, Next.js 等）、そこに追記するだけで動きます：

# アプリ側の .env
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_API_KEY=your-api-key
AZURE_OPENAI_DEPLOYMENT_NAME=gpt-5.1
AZURE_OPENAI_DEPLOYMENT_NAME_IMAGE=gpt-image-1.5

使用例

import {
  AzureImageClient,
  AzureChatClient,
  getAzureConfig,
  saveFileWithUniqueNameIfExists,
} from "@nogataka/imgen/sdk";

// Azure OpenAI 設定を取得（環境変数 or .envファイル）
const config = await getAzureConfig();

// 画像生成
const imageClient = new AzureImageClient(config);
const imageBytes = await imageClient.generateImage("夕日の海辺", {
  size: "1536x1024",
  quality: "high",
});
const savedPath = await saveFileWithUniqueNameIfExists("sunset.png", imageBytes);

// プロンプト拡張・画像説明
const chatClient = new AzureChatClient(config);
const prompt = await chatClient.generatePrompt("可愛い猫のマスコット");
const fileName = await chatClient.generateFileName("可愛い猫のマスコット");

// 画像編集
import * as fs from "node:fs/promises";
const photo = Buffer.from(await fs.readFile("photo.jpg"));
const edited = await imageClient.editImage(photo, "背景を青空に変更");

// 画像説明
import { readImageFile } from "@nogataka/imgen/sdk";
const imgData = await readImageFile("screenshot.png");
const explanation = await chatClient.generateExplanation(imgData, "ja");

LLM ツールとしての組み込み例

import { AzureImageClient, AzureChatClient, getAzureConfig, saveFileWithUniqueNameIfExists } from "@nogataka/imgen/sdk";

const generateImageTool = {
  name: "generate_image",
  description: "テキストから画像を生成する",
  execute: async ({ theme }: { theme: string }) => {
    const config = await getAzureConfig();
    const chat = new AzureChatClient(config);
    const image = new AzureImageClient(config);

    const prompt = await chat.generatePrompt(theme);
    const fileName = await chat.generateFileName(theme);
    const bytes = await image.generateImage(prompt, { size: "1024x1024", quality: "high" });
    const path = await saveFileWithUniqueNameIfExists(`${fileName}.png`, bytes);
    return { path };
  },
};

開発

git clone https://github.com/nogataka/imgen.git
cd imgen
npm install
cp .env.example .env  # Azure OpenAI の認証情報を記入

npm run dev -- image gen "テスト"   # 開発実行
npm test                            # テスト
npm run check                       # 型チェック
npm run lint                        # ESLint
npm run check-all                   # 全チェック（型+lint+format+テスト）
npm run build                       # ビルド

ライセンス

MIT