コマンドラインAIツールでターミナルからAI画像を生成する方法
コマンドラインAIツールを使うと、Web UIをクリックして操作する代わりに、ターミナルからAI生成タスクを実行できます。画像生成では、プロンプトを書き、モデルを選び、画像を生成し、出力を保存し、同じワークフローをスクリプトや自動化の中で再利用できます。
このガイドでは、PiAPI CLIを使ってターミナルワークフローからAI画像を生成する方法を紹介します。CLIのインストールやAPI keyの接続がまだの場合は、先にPiAPI CLI quick startを確認してから、このワークフローガイドに戻ってください。
クイック回答
ターミナルからAI画像を生成するには、PiAPI CLIのようなコマンドラインAIツールをインストールし、API keyで認証し、テキストプロンプトで画像モデルを実行し、結果をローカル保存したい場合は--downloadを追加します。
コマンドラインAIツールとは？
コマンドラインAIツールは、ターミナルコマンドでAIモデルを呼び出せるCLIプログラムです。Webアプリを開く代わりに、コマンドを実行し、入力をflagやargumentとして渡し、保存、解析、再利用できる構造化された出力を受け取ります。
定義
コマンドラインAIツールは、開発者がプロンプト、ファイル、設定をコマンド引数として渡し、ターミナルからAIモデルを実行できるソフトウェアです。画像生成では、ターミナルコマンドを繰り返し使えるtext-to-imageワークフローに変えます。
AI画像生成では、コマンドラインAIツールは次のような場合に役立ちます。
- 繰り返し使えるプロンプトから画像を生成したい
- 出力をプロジェクトフォルダに保存したい
- 複数のプロンプトバリエーションを素早くテストしたい
- プロンプト一覧から画像を一括生成したい
- 画像生成をshell script、CI job、AI agent workflowに追加したい
PiAPI CLIはマルチモーダル生成向けに作られているため、同じターミナルワークフローで画像、動画、音声、3D、chatモデルを扱えます。
なぜターミナルからAI画像を生成するのか？
画像生成タスクが繰り返し使うワークフローの一部である場合、ターミナルは便利です。Web UIは視覚的な探索に向いていますが、CLIならコピー、編集、バージョン管理、自動化できるコマンドとして残せます。
次のような場合は、ターミナルベースの画像生成を使います。
- 1つのプロンプトから多くのバリエーションを作る
- 生成されたassetを予測しやすいフォルダに保存する
- アプリ開発中にモデル挙動をテストする
- 同じ生成ワークフローを複数回実行する
- 画像生成をスクリプトやAI agentと接続する
要するに、画像タスクを繰り返し可能、スクリプト化可能、または大きな開発ワークフローの一部にしたい場合は、コマンドラインAIツールを使います。
最適な用途: ターミナル画像生成ワークフローは、再現性が必要な開発者に向いています。同じプロンプト、モデル、出力フォルダを複数回使うなら、CLIはWeb UIでクリックするより効率的です。
始める前に必要なもの
ターミナルから画像を生成する前に、次を用意してください。
- Node.js 18以上
- PiAPIアカウント
- PiAPI API key
- インストール済みのPiAPI CLI
PiAPI workspaceからアカウントを作成し、API keyを取得できます。
まだインストールしていない場合は、次を使います。
npm install -g piapi-cli次に認証します。
piapi auth login --api-key sk-xxxxxより詳しいセットアップ手順は、PiAPI CLI quick startを参照してください。
ターミナルから最初のAI画像を生成する
認証後、piapi runで画像を生成できます。正確なモデル名やパラメータは選ぶモデルによって変わる場合がありますが、流れは同じです。モデルを選び、プロンプトを渡し、コマンドを実行します。
piapi run flux-dev prompt="a cinematic product photo of a ceramic coffee mug on a wooden desk, soft morning light"期待される結果: PiAPI CLIが選択した画像モデルにプロンプトを送り、生成結果をターミナルに返します。
これはPiAPI CLIをAI画像生成CLIとして使う最もシンプルな方法です。1つのコマンド、1つのモデル、1つのプロンプトです。
コマンドラインからAI画像をローカル保存する
実際の作業では、結果URLを見るだけでなく、画像ファイルをローカルに保存したいことが多いです。PiAPI CLIに生成出力を現在のフォルダへ保存させたい場合は、CLIのdownloadオプションを使います。
piapi run flux-dev prompt="a minimalist app icon of a blue lightning bolt on a white background" --download期待される結果: 生成された画像がローカルにダウンロードされます。
プロジェクトフォルダからコマンドを実行して、出力を整理することもできます。
mkdir ai-assets
cd ai-assets
piapi run flux-dev prompt="a clean hero image for a developer API dashboard, dark UI, neon accents" --download選択したモデルで出力ディレクトリflagがサポートされている場合は、専用フォルダに出力を保存することもできます。
piapi run flux-dev prompt="a clean hero image for a developer API dashboard, dark UI, neon accents" --download --out-dir ./ai-assetsこれにより、ターミナル画像生成はdesign asset、広告バリエーション、テスト画像、コンテンツワークフローに実用的になります。
複数のプロンプトからAI画像を一括生成する
一括生成では、コマンドラインAIツールがWeb UIより便利になります。プロンプトを1つずつ入力する代わりに、テキストファイルに保存してループ処理できます。
prompts.txtというファイルを作成します。
a futuristic sneaker product photo on a reflective floor
a cozy coffee shop interior in watercolor style
a mobile app hero image showing a secure payment dashboard
a cinematic close-up of a robot hand holding a flower次に、利用しているOSに合わせてループを実行します。
一括コマンドを実行する前に、ファイルにプロンプトが入っていることを確認します。
Windows PowerShellの場合:
Get-Content .\\prompts.txtmacOSまたはLinuxのbash/zshの場合:
cat prompts.txtWindows PowerShellの場合:
Get-Content .\prompts.txt | ForEach-Object {
piapi run flux-dev prompt="$_" --download
}macOSまたはLinuxのbash/zshの場合:
while read prompt; do
piapi run flux-dev prompt="$prompt" --download
done < prompts.txt期待される結果: PiAPI CLIがファイル内の各プロンプトに対して1枚ずつ画像を生成し、出力をローカルに保存します。
WindowsでMissing opening '(' after keyword 'while'のようなエラーが出る場合、bashコマンドをPowerShellに貼り付けています。PowerShell版を使ってください。
このワークフローは、複数のクリエイティブ方向を試す、プロンプトライブラリを作る、marketing assetを一括生成する場合に便利です。
スクリプトと自動化でコマンドラインAIツールを使う
CLIワークフローはスクリプトにまとめることもできます。画像生成が繰り返し使う社内プロセスの一部である場合に便利です。
たとえば、generate-assets.shというスクリプトを作成します。
#!/usr/bin/env bash
set -e
mkdir -p generated-assets
cd generated-assets
piapi run flux-dev prompt="a SaaS dashboard hero image, clean interface, professional lighting" --download
piapi run flux-dev prompt="an isometric illustration of an AI API workflow" --download
piapi run flux-dev prompt="a product launch banner with abstract blue motion trails" --download次に実行します。
bash generate-assets.sh期待される結果: スクリプトがフォルダを作成し、複数の生成画像をその中に保存します。
Windowsでは、generate-assets.ps1というPowerShellスクリプトを作成できます。
New-Item -ItemType Directory -Force -Path .\generated-assets | Out-Null
Set-Location .\generated-assets
piapi run flux-dev prompt="a SaaS dashboard hero image, clean interface, professional lighting" --download
piapi run flux-dev prompt="an isometric illustration of an AI API workflow" --download
piapi run flux-dev prompt="a product launch banner with abstract blue motion trails" --download次に実行します。
powershell -ExecutionPolicy Bypass -File .\\generate-assets.ps1これは、再現可能なasset生成ワークフローを持ちたいチームに特に便利です。各プロンプトを手動で覚える代わりに、ワークフローをスクリプトに保存し、必要に応じて更新できます。
CLIからFluxや他の画像モデルで画像を生成する
多くの開発者は、ターミナルからFLUX画像を生成したいためFlux CLIを探します。PiAPI CLIは、このようなモデル固有のワークフローをサポートしつつ、複数のモデルファミリーで1つのコマンドラインインターフェースを維持できます。モデル固有の詳細はFlux APIも確認できます。
たとえば、高速な画像生成にはFlux風のワークフローを使えます。
piapi run flux-dev prompt="a high-detail concept art scene of a solar-powered city at sunset" --downloadアカウントと利用可能なモデル一覧に応じて、同じCLIアプローチを他の対応画像モデルにも使えます。別の画像モデルが必要な場合、PiAPIにはGPT Image 2 API、Nano Banana API、Seedream APIなどの選択肢もあります。
piapi model list期待される結果: PiAPI CLIが利用可能なモデルと対応入力フィールドを表示します。
PiAPI CLIをモデルごとの別ツールではなく使う利点は、1つのターミナルワークフローを保ちながら必要に応じてモデルを切り替えられることです。
コマンドラインAIツール vs Web UI vs 直接API
それぞれ別のワークフローに向いています。
| 選択肢 | 最適な用途 | 注意点 |
|---|---|---|
| Web UI | 視覚的な探索と単発生成 | 繰り返しや自動化が難しい |
| コマンドラインAIツール | 繰り返し可能なターミナルワークフロー、一括プロンプト、ローカルファイル、scripting | ターミナルコマンドに慣れている必要がある |
| 直接API | 本番アプリとbackend連携 | より多くのエンジニアリング設定が必要 |
視覚的に探索したい場合はWeb UIを使います。ワークフローがターミナルから始まる場合はPiAPI CLIを使います。画像生成をプロダクトやbackend serviceに組み込む場合は直接APIを使います。
最もシンプルなルールは、探索にはWeb UI、繰り返し使うローカルワークフローにはCLI、本番ソフトウェアにはAPIです。PiAPI CLIはWeb UIと直接APIの間にあり、完全なbackend統合なしでscriptableなインターフェースを提供します。
ターミナルから画像生成するときのよくある問題
コマンドが見つからない
piapiが認識されない場合は、CLIがグローバルにインストールされているか確認します。
npm install -g piapi-cliグローバルインストールなしで実行することもできます。
npx piapi-cli@latest --helpCLIが認証されていない
CLIがアカウントにアクセスできない場合は、再度ログインします。
piapi auth login --api-key sk-xxxxx共有マシンやスクリプトでは、環境変数を使うのがおすすめです。
export PIAPI_API_KEY=sk-xxxxxモデル名またはパラメータが間違っている
利用可能なモデルと必要なフィールドを確認するには、モデル一覧コマンドを使います。
piapi model listコマンドが失敗した場合は、モデル名、promptパラメータ、ファイルパス、選択したモデルにアカウントがアクセスできるかを確認してください。
FAQ
コマンドラインAIツールとは何ですか？
コマンドラインAIツールは、ターミナルコマンドからAIタスクを実行できるCLIプログラムです。画像生成では、画像モデルへプロンプトを送り、結果を受け取り、Web UIを開かずに出力を保存できます。
ターミナルからAI画像を生成できますか？
はい。PiAPI CLIでは、画像モデルを選び、プロンプトを渡し、結果をローカルにダウンロードすることで、ターミナルコマンドからAI画像を生成できます。同じコマンドを保存、編集、再利用できるため、ワークフローを繰り返し使えます。
PiAPI CLIは画像生成専用ですか？
いいえ。PiAPI CLIは画像、動画、音声、3D、chatモデルなどのマルチモーダルワークフローをサポートします。この記事では、一般的なターミナル自動化の用途として画像生成に焦点を当てています。
AI画像を一括生成できますか？
はい。プロンプトをテキストファイルに入れ、PowerShell、bash、zshでループ処理できます。各プロンプトを手入力せずに、コマンドラインから複数の画像を生成できます。
AI画像生成にはCLIとAPIのどちらを使うべきですか？
高速なターミナル作業、ローカルテスト、一括プロンプト、自動化スクリプトにはCLIを使います。本番アプリやバックエンドサービスに画像生成を組み込む場合はAPIを使います。
PiAPI CLIでAI画像生成を始める
PiAPI CLIは、開発者がターミナルワークフローからAI画像を生成する実用的な方法を提供します。単発プロンプトの実行、ローカル保存、一括生成、スクリプトやAI agent内でのワークフロー再利用ができます。
製品を確認するには、PiAPI CLIページをご覧ください。先にセットアップの help が必要な場合は、PiAPI CLI quick startを読んでください。
