PiAPI CLI Quick Start: ターミナルからAI画像と動画を生成
PiAPI CLIはPiAPI公式のコマンドラインインターフェースです。画像、動画、音声、3D、LLM向けのマルチモーダルAIモデルをターミナルから直接呼び出せます。
このクイックスタートでは、インストール、APIキー認証、最初の画像生成、async動画タスク、利用可能モデルの確認までを説明します。
PiAPI CLIとは？
クイック定義
PiAPI CLIは、Webダッシュボードを開かずにPiAPIモデルを実行するNode.jsコマンドラインツールです。
AI CLIは、生成ワークフローがターミナルから始まる場合に便利です。コマンドを保存し、再実行し、パラメータを変え、スクリプトやAIエージェントへ組み込めます。
- 再利用できるプロンプトからassetを生成
- アプリやプロトタイプ開発中に素早くテスト
- プロジェクトフォルダからローカルファイルをアップロード
- 出力を決まったフォルダへ保存
- スクリプト、CI、エージェント向けにJSONを返す
PiAPI CLIの概要
| パッケージ | piapi-cli |
|---|---|
| コマンド | piapi |
| Runtime | Node.js 18+ |
| 主な用途 | ターミナルでのマルチモーダルAI生成 |
| 向いている人 | 開発者、自動化、AIエージェント |
事前準備
- Node.js 18以上
- PiAPI API key
- ターミナルアプリ
PiAPI CLIをインストール
好みのJavaScript package managerでpiapi-cliをインストールします。
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpPiAPI API keyで認証
インストール後、CLIをPiAPIアカウントに接続します。
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...ターミナルから最初のAI画像を生成
認証後、piapi runでターミナルからAI画像を生成できます。
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>ローカルファイルをアップロードして結果をダウンロード
入力値が@で始まるとPiAPI CLIはローカルファイルをアップロードし、結果を指定フォルダへダウンロードできます。
piapi run remove-bg image=@./photo.png --download --out-dir ./outモデルを確認してquotaをチェック
modelコマンドでモデル、schema、quotaを確認します。
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quota便利なPiAPI CLI flags
自動化に便利なflags:
--async | CLI workflow option |
--download | CLI workflow option |
--out-dir <path> | CLI workflow option |
--stream | CLI workflow option |
--dry-run | CLI workflow option |
--output json | JSON output for scripts and automation |
--webhook <url> | CLI workflow option |
--quiet | CLI workflow option |
--non-interactive | CLI workflow option |
AIエージェントと自動化でPiAPI CLIを使う
PiAPI CLIはAIエージェント、shell script、CI job、自動化workflowでも使えます。
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
PiAPI CLIのよくある問題
最初のコマンドが動かない場合、promptやmodelを変える前に次のよくある問題を確認してください。
piapiコマンドが見つからない
npx piapi-cli@latest --help
API keyが無効または未設定
piapi auth status
動画コマンドがファイルではなくtask IDを返す
piapi task get <id>
Web UIではなくPiAPI CLIを使う場面
再現可能、script化可能、AIエージェントに渡せるworkflowが必要ならPiAPI CLIを使います。Web UIは視覚的な探索に、CLIは自動化に向いています。
FAQ
PiAPI CLIとは？
PiAPI CLIは、Webダッシュボードを開かずにPiAPIモデルを実行するNode.jsコマンドラインツールです。
PiAPI CLIのインストール方法は？
npm install -g piapi-cli / npx piapi-cli@latest --help
ターミナルからAI画像と動画を生成できますか？
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
PiAPI CLIで作り始める
PiAPI CLIは、開発者とAIエージェントが画像、動画、音声、3D asset、LLM応答をコマンドラインから生成するための実用的な方法です。
