PiAPI CLI 快速開始：從終端機生成 AI 圖片和影片
PiAPI CLI 是 PiAPI 官方命令列工具，可從終端機直接呼叫圖片、影片、音訊、3D 和 LLM 等多模態 AI 模型。
這篇快速開始會介紹安裝、API key 驗證、第一次圖片生成、async 影片任務，以及如何查看可用模型。
PiAPI CLI 是什麼？
快速定義
PiAPI CLI 是一個 Node.js 命令列工具，可在不開啟 Web dashboard 的情況下執行 PiAPI 模型。
當生成流程從終端機開始時，AI CLI 很實用：你可以儲存指令、重複執行、修改參數，並放進 scripts 或 AI agent。
- 用可重複 prompt 生成素材
- 開發 app 或 prototype 時快速測試
- 從專案資料夾上傳本機檔案
- 把輸出儲存到固定資料夾
- 為 scripts、CI 或 agent 回傳 JSON
PiAPI CLI 概覽
| 套件 | piapi-cli |
|---|---|
| 指令 | piapi |
| Runtime | Node.js 18+ |
| 主要用途 | 終端機內多模態 AI 生成 |
| 適合對象 | 開發者、自動化 workflow 和 AI agents |
準備條件
- 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 --help使用 PiAPI 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 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 選項 |
--download | CLI workflow 選項 |
--out-dir <path> | CLI workflow 選項 |
--stream | CLI workflow 選項 |
--dry-run | CLI workflow 選項 |
--output json | JSON output for scripts and automation |
--webhook <url> | CLI workflow 選項 |
--quiet | CLI workflow 選項 |
--non-interactive | CLI workflow 選項 |
在 AI agents 和自動化中使用 PiAPI CLI
PiAPI CLI 也可用於 AI agent、shell scripts、CI jobs 和自動化 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>
什麼時候用 PiAPI CLI 而不是 Web UI？
當你需要可重複、可 script 化或可交給 AI agent 的 workflow 時使用 PiAPI CLI。Web UI 適合視覺探索；CLI 更適合自動化。
FAQ
PiAPI CLI 是什麼？
PiAPI CLI 是一個 Node.js 命令列工具，可在不開啟 Web dashboard 的情況下執行 PiAPI 模型。
如何安裝 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 agents 能從命令列生成圖片、影片、音訊、3D assets 和 LLM responses。
