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