aiimage-cli

AI画像生成CLI - Gemini, fal.ai, SVG Diagram, Mermaid変換をサポート

3つのコマンドを提供:

コマンド	用途	必要なAPIキー
`aiimage`	AI画像生成	Gemini or fal.ai
`aidiagram`	AI SVG図解→画像	Gemini
`aimermaid`	Mermaid→画像変換	なし

インストール

npm install -g aiimage-cli

aimermaid を使う場合は mermaid-cli も必要です:

npm install -g @mermaid-js/mermaid-cli

初回セットアップ

初めて実行すると、セットアップウィザードが起動します:

aiimage "test prompt" -o test.png

または手動でセットアップ:

aiimage --setup

以下のAPIキーを設定します:

Gemini API Key: https://aistudio.google.com/apikey
fal.ai API Key: https://fal.ai/dashboard/keys

基本的な使い方

# シンプルな画像生成 (fal.ai使用)
aiimage "A sunset over mountains" -o sunset.png

# 高品質モード
aiimage "Cute cat portrait" -o cat.png -q high

# Geminiを使用
aiimage "Modern abstract art" -o art.png -P gemini

# 参照画像を使用 (Geminiのみ)
aiimage "Same style image" -o new.png -P gemini -r reference.png

オプション

オプション	説明	デフォルト
`-o, --output <path>`	出力ファイルパス (必須)	-
`-P, --provider <name>`	プロバイダー: `gemini` or `fal`	config
`-s, --size <size>`	サイズ: `square`, `hor`, `ver`	`hor`
`-q, --quality <level>`	品質: `low`, `medium`, `high` (fal用)	`low`
`-r, --ref-image <path>`	参照画像パス (gemini用)	-
`--ref-instruction <text>`	参照画像の使用指示	-
`--config`	設定ファイルを開く	-
`--setup`	セットアップウィザードを実行	-

サイズオプション

サイズ	説明	fal.ai	Gemini
`hor`	横長 (デフォルト)	1536x1024	16:9
`square`	正方形	1024x1024	1:1
`ver`	縦長	1024x1536	9:16

品質レベル (fal.ai)

レベル	説明
`low`	高速生成、シンプルな画像向け
`medium`	バランス型、詳細な画像向け
`high`	最高品質、日本語テキスト含む詳細画像向け

設定

設定ファイルは ~/.aiimage/config.json に保存されます。

# 設定ファイルを開く
aiimage --config

設定ファイルの例

{
  "defaultProvider": "fal",
  "defaultSize": "hor",
  "gemini": {
    "apiKey": "your-gemini-api-key",
    "model": "gemini-3.1-flash-image-preview"
  },
  "fal": {
    "apiKey": "your-fal-api-key",
    "model": "fal-ai/gpt-image-1.5",
    "defaultQuality": "low"
  }
}

例

# YouTubeサムネイル用 (高品質、横長)
aiimage "AIの未来を語る女性YouTuber、驚きの表情" -o thumbnail.png -q high

# SNS用正方形画像
aiimage "Minimalist coffee cup illustration" -o coffee.png -s square

# 縦長のポートレート
aiimage "Portrait of a woman" -o portrait.png -s ver -q medium

# Geminiを使用
aiimage "Abstract technology background" -o bg.png -P gemini

# 参照画像を使ってスタイルを真似る (Gemini)
aiimage "新しいテーマで同じスタイル" -o styled.png -P gemini -r original.png --ref-instruction "この画像の色彩とタッチを真似て"

aidiagram - AI図解生成

Gemini APIでSVG図解を生成し、画像で出力します。

# PNG出力（推奨）
aidiagram "システムアーキテクチャ図" -o arch.png

# ライトテーマ
aidiagram "API連携フロー" -o flow.webp -t light

# SVG生出力
aidiagram "ER図" -o er.svg

オプション	説明	デフォルト
`-o, --output <path>`	出力パス `.png` `.webp` `.jpg` `.svg`	-
`-t, --theme <theme>`	`dark` or `light`	`dark`
`-m, --model <model>`	Gemini モデルID	`gemini-3-flash-preview`

aimermaid - Mermaid図変換

Mermaidテキストを画像に変換します。APIキー不要。

# インライン
aimermaid "graph TD; A-->B-->C" -o flow.webp

# ファイルから
aimermaid -i diagram.mmd -o output.webp

# ダークテーマ + PNG
aimermaid -i seq.mmd -o seq.png -t dark -b black

オプション	説明	デフォルト
`-i, --input <path>`	入力 `.mmd` ファイル	-
`-o, --output <path>`	出力パス `.webp` `.png`	-
`-t, --theme <theme>`	`default` `dark` `forest` `neutral`	`default`
`-b, --background <color>`	背景色	`white`
`-W, --width <px>`	出力幅	`1920`
`-H, --height <px>`	出力高さ	`1080`
`-q, --quality <n>`	WebP品質 1-100	`85`

前提条件: npm install -g @mermaid-js/mermaid-cli が必要です。

ライセンス

MIT

リリース手順（npm）

# 内容確認（公開されるファイル一覧）
npm run pack:check

# バージョン更新（例: patch）
npm version patch

# 公開
npm publish