如何用命令列 AI 工具在終端機生成 AI 圖片
命令列 AI 工具可以讓你直接在終端機執行 AI 生成任務，而不是透過網頁介面點擊操作。對於圖片生成，這表示你可以撰寫提示詞、選擇模型、生成圖片、儲存輸出，並在腳本或自動化流程中重複使用同一套工作流程。
本指南介紹如何使用 PiAPI CLI 從終端機工作流程生成 AI 圖片。如果你還需要安裝 CLI 或連接 API key，請先閱讀 PiAPI CLI quick start，然後再回到這份工作流程指南。
快速回答
要從終端機生成 AI 圖片，請安裝 PiAPI CLI 這類命令列 AI 工具，使用 API key 完成認證，以文字提示詞執行圖片模型，並在需要將結果儲存在本機時加上 --download。
什麼是命令列 AI 工具？
命令列 AI 工具是一個 CLI 程式，可透過終端機命令呼叫 AI 模型。你不需要開啟網頁應用程式，而是執行命令，將輸入作為 flag 或 argument 傳入，並接收可儲存、解析或重複使用的結構化輸出。
定義
命令列 AI 工具是一類軟體，讓開發者能在終端機中透過命令參數傳入提示詞、檔案和設定來執行 AI 模型。對於圖片生成，它會把終端機命令變成可重複使用的 text-to-image 工作流程。
在 AI 圖片生成中，命令列 AI 工具適合以下情境：
- 從可重複使用的提示詞生成圖片
- 將輸出儲存到專案資料夾
- 快速測試多個提示詞變體
- 從提示詞清單批次生成圖片
- 把圖片生成加入 shell script、CI job 或 AI agent workflow
PiAPI CLI 是為多模態生成而設計，因此同一個終端機工作流程可以支援圖片、影片、音訊、3D 和 chat 模型。
為什麼要從終端機生成 AI 圖片？
當圖片生成任務是可重複工作流程的一部分時，終端機非常有用。Web UI 適合視覺探索，但 CLI 會給你一個可以複製、編輯、版本管理和自動化的命令。
當你需要以下能力時，適合使用終端機圖片生成：
- 為一個提示詞建立多個變體
- 將生成的素材儲存到可預測的資料夾
- 在建置應用程式時測試模型行為
- 多次執行同一個生成工作流程
- 將圖片生成連接到腳本或 AI agents
簡單來說，當圖片任務需要可重複、可腳本化，或成為更大開發工作流程的一部分時，就適合使用命令列 AI 工具。
最適合：終端機圖片生成工作流程適合需要可重複性的開發者。如果同一個提示詞、模型或輸出資料夾會被多次使用，CLI 通常比在 Web UI 中點擊更有效率。: 最適合：終端機圖片生成工作流程適合需要可重複性的開發者。如果同一個提示詞、模型或輸出資料夾會被多次使用，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 使用的最簡單方式：一個命令、一個模型、一個提示詞。
從命令列將 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這讓終端機圖片生成適用於設計素材、廣告變體、測試圖片和內容工作流程。
從多個提示詞批次生成 AI 圖片
批次生成是命令列 AI 工具比 Web UI 更有用的地方。你不需要逐一輸入提示詞，而是可以把提示詞保存在文字檔中並迴圈處理。
建立一個名為 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接著依照你的作業系統執行迴圈。
執行批次命令前，請確認檔案中包含提示詞。
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 會為檔案中的每個提示詞生成一張圖片，並將輸出儲存在本機。
如果你使用 Windows 並看到 Missing opening '(' after keyword 'while' 這類錯誤，表示你把 bash 命令貼到 PowerShell 裡了。請改用 PowerShell 版本。
這個工作流程適合測試多個創意方向、建立提示詞庫，或批次生成 marketing assets。
在腳本和自動化中使用命令列 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這對希望擁有可重複素材生成工作流程的團隊特別有用。你不需要手動記住每個提示詞，而是將工作流程保存在腳本中，並在需要時更新。
透過 CLI 使用 Flux 和其他圖片模型生成圖片
許多開發者搜尋 Flux CLI，是因為他們想從終端機生成 FLUX 圖片。PiAPI CLI 可以支援這類模型專屬工作流程，同時在多個模型系列之間維持單一命令列介面。關於模型細節，你也可以查看 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 而不是為每個模型準備單獨工具的優勢：你可以保留一個終端機工作流程，並依需要切換模型。
命令列 AI 工具 vs Web UI vs 直接 API
每種方式都適合不同的工作流程。
| 選項 | 最適合 | 取捨 |
|---|---|---|
| Web UI | 視覺探索和一次性生成 | 較難重複或自動化 |
| 命令列 AI 工具 | 可重複終端機工作流程、批次提示詞、本機檔案、scripting | 需要熟悉終端機命令 |
| 直接 API | Production apps 和 backend integrations | 需要更多工程設定 |
當你想進行視覺探索時，使用 Web UI。當你的工作流程從終端機開始時，使用 PiAPI CLI。當你要把圖片生成建置到產品或 backend service 中時，使用直接 API。
最簡單的規則是：Web UI 用於探索，CLI 用於可重複的本機工作流程，API 用於 production software。PiAPI CLI 位於 Web UI 和直接 API 之間，因為它為開發者提供可腳本化介面，而不需要完整的 backend integration。
從終端機生成圖片時的常見問題
找不到命令
如果 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 工具是一個 CLI 程式，可透過終端機命令執行 AI 任務。用於圖片生成時，它能將提示詞傳送到圖片模型、接收結果，並在不開啟網頁介面的情況下儲存輸出。
我可以從終端機生成 AI 圖片嗎？
可以。使用 PiAPI CLI，你可以透過終端機命令選擇圖片模型、傳入提示詞，並將結果下載到本機。這讓工作流程可以重複使用，因為同一個命令可以儲存、編輯和重複使用。
PiAPI CLI 只用於圖片生成嗎？
不是。PiAPI CLI 支援多模態工作流程，包括圖片、影片、音訊、3D 和 chat 模型。本文聚焦圖片生成，因為這是最常見的終端機自動化場景之一。
我可以批次生成 AI 圖片嗎？
可以。你可以把提示詞放進文字檔，並用 PowerShell、bash 或 zsh 迴圈處理。這可以從命令列生成多張圖片，而不需要手動輸入每個提示詞。
AI 圖片生成應該用 CLI 還是 API？
如果你需要快速終端機流程、本機測試、批次提示詞或自動化腳本，使用 CLI。如果你要把圖片生成整合到 production app 或 backend service，使用 API。
開始用 PiAPI CLI 生成 AI 圖片
PiAPI CLI 為開發者提供了一種從終端機工作流程生成 AI 圖片的實用方式。你可以執行一次性提示詞、將輸出儲存在本機、批次生成圖片，並在腳本或 AI agents 中重複使用同一套工作流程。
若要了解產品，請前往 PiAPI CLI 頁面。如果你需要先完成設定，請閱讀 PiAPI CLI quick start。
