官方命令列工具
ZOOOP AI CLI：在終端機裡生成圖片、影片和音訊
裝一個 npm 套件，終端機就能用上 70 多個 AI 模型，包括 GPT Image、Nano Banana、Seedance、Kling 和 ElevenLabs。透過瀏覽器登入後，一個指令就能報價、生成並下載結果，也能寫進腳本或 CI。
npx zooop login支援 macOS、Linux 和 Windows · Node.js 18 以上 · 無其他相依套件
直接呼叫你熟悉的主流模型
- GPT Image 2.5
- Nano Banana 2.1
- Seedream 5.0
- Midjourney V8.2
- Seedance 2.5
- Kling
- Wan 3.0
- Vidu Q4
- MiniMax H3
- Gemini Omni
- Grok Imagine
- ElevenLabs
- 個 AI 模型
- 70+
- 種媒體類型
- 3
- 個指令完成登入
- 1
- 個額外相依套件
- 0
所有熱門模型，一個指令搞定
CLI 即時讀取 ZOOOP 模型目錄，新上架的圖片、影片、音訊模型當天就能用，不必更新 CLI。
$zooop models --type video為終端機和腳本而生
每個指令都支援 --json，stdout 乾淨、可直接接管線，進度輸出到 stderr，結束代碼也有明確含義。可以直接放進 shell 腳本、Makefile 或 CI 工作。
$zooop tasks --json | jq .tasks[0].status按用量付費的積分
生成費用從你的 ZOOOP 積分餘額扣除。不用訂閱，積分永不過期，執行前就能看到確切價格。
$zooop quote --template claymation-me能生成什麼
ZOOOP 公開 API 提供的全部功能，加上模板庫裡的一鍵模板，以及去背、超解析度這類專用 AI 工具。
圖片
文字生圖、圖生圖、用提示詞修圖、局部重繪、SVG 向量圖、超解析度和去背。
影片
文字生影片、讓靜態圖動起來、首尾影格插補、動作遷移、對嘴、延長影片和風格重繪。
音訊
指定音色的文字轉語音、用樣本複製聲音、音效和完整的音樂。
模型清單即時讀取自模型目錄，今天上架的模型今天就能用。瀏覽全部模型。
每個模板，一個指令
模板庫裡的一鍵模板同樣能在終端機裡執行。zooop templates show 會列出模板需要的輸入，zooop run --template 則用你的照片直接生成。
三步開始
大約兩分鐘。你需要一個終端機和一個 ZOOOP 帳戶。
- 1
安裝 CLI
用套件管理工具全域安裝，或用 npx 直接執行。只需要 Node.js 18 以上，不需要其他東西。
npm install -g zooopzooop --help為目前的使用者帳戶安裝 zooop 指令。
- 2
透過瀏覽器登入
執行 zooop login 會顯示一組簡短的確認碼並開啟 zooop.ai/cli/login。確認瀏覽器裡顯示的是同一組碼，選好帳戶和專案，點「授權」即可，不必複製貼上任何金鑰。
為 CI 建立 API 金鑰只授權你自己發起的登入。隨時可以在 API 金鑰頁面或用 zooop logout 撤銷這把金鑰。
zooop login會開啟你的預設瀏覽器。金鑰只儲存在這台電腦上，存放的檔案只有你本人可讀。
- 3
第一次生成
先找模型、看價格，再執行。CLI 會等待結果，並儲存到目前的目錄。
第一次執行zooop models --type image --subtype defaultzooop quote --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"zooop run --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"
用瀏覽器登入，不必貼上金鑰
zooop login 會顯示一組簡短的確認碼並開啟 zooop.ai/cli/login。核對兩邊的確認碼一致後點「授權」，CLI 就登入完成了。金鑰全程不經過你的剪貼簿。
終端機顯示一次性確認碼
瀏覽器顯示同一組碼，點「授權」
CLI 已登入，金鑰只儲存在本機
指令一覽
每個指令都支援 --json 和 -h。在任何指令後加上 --help，即可查看它的所有選項。
- zooop login
透過瀏覽器登入，為這台電腦儲存一把金鑰。
zooop login- zooop whoami
查看帳戶、專案、積分餘額和金鑰到期時間。
zooop whoami- zooop models
列出模型及其版本、輸入參數和參考價格。
zooop models --type video --subtype text-ref- zooop templates
瀏覽模板庫，查看每個模板需要哪些輸入。
zooop templates show <slug>- zooop tools
列出去背、超解析度等 AI 工具。
zooop tools- zooop quote
只報價，不執行。
zooop quote --model <id> --version <id> -p prompt="..."- zooop run
送出請求、等待結果並下載。本機檔案會自動上傳。
zooop run --template <slug> -p image_url=@photo.jpg- zooop tasks
列出最近的任務、查看或等待某個任務，也能取消排隊中的任務。
zooop tasks get <task-id> --wait- zooop upload
上傳圖片、影片或音訊檔案，並輸出它的 URL。
zooop upload ./clip.mp4- zooop describe
把一張圖轉成可重複使用的提示詞（1 積分）。
zooop describe @./reference.jpg- zooop logout
在伺服器上撤銷已儲存的金鑰，並刪除本機憑證。
zooop logout
範例
複製一條，把模型 ID 換成 zooop models 裡的，直接執行。
文字生圖
生成一張寬螢幕畫面，儲存到 ./renders。
zooop run --model <model-id> --version <version-id> \ -p prompt="a neon-lit rainy Tokyo alley, cinematic" \ -p aspect_ratio=16:9 --out ./renders圖生影片
讓本機照片動起來。檔案會先上傳；參數名稱以 zooop models 顯示的為準。
zooop run --model <model-id> --version <version-id> \ -p prompt="slow push-in, hair moving in the wind" \ -p image_url=@./portrait.jpg -p duration=5執行模板
選一個模板，放入你的照片。
zooop templates --type videozooop run --template <slug> -p 'image_urls=["@./me.jpg"]' --out ./results用腳本批次生成
一次送出多個提示詞，用 jq 收集任務 ID。
for subject in "red fox" "snow owl" "arctic hare"; do zooop run --model <model-id> --version <version-id> \ -p prompt="$subject, studio photo" --no-wait --json | jq -r .taskIddonezooop tasks --status running預設就安全
CLI 花的是真正的積分，所以在金鑰和費用上都很謹慎。
- 金鑰不進指令歷史
- 瀏覽器登入會直接把金鑰交給 CLI，不需要貼上，金鑰存放的檔案只有你本人可讀。
- 每把金鑰都有限制
- 每把 CLI 金鑰會在 30、90 或 365 天後過期，只綁定一個專案，授權時還能設定每日積分上限。
- 先知道價格
- zooop quote 會在執行前告訴你確切的積分花費和預計耗時。
- 重試不會重複扣款
- 每次執行都帶有冪等鍵，24 小時內重複執行同一個指令會回傳既有任務，不會再次扣款。
常見問題
ZOOOP AI CLI 是什麼？
ZOOOP 的免費命令列用戶端。你可以在終端機或腳本裡生成 AI 圖片、影片和音訊，使用的模型和積分與網頁版完全相同。
執行它需要什麼？
macOS、Linux 或 Windows 上的 Node.js 18.17 以上，再加一個 ZOOOP 帳戶。這個套件沒有其他相依套件。
可以用哪些模型？
ZOOOP 公開 API 上的所有模型：GPT Image、Nano Banana 等圖片模型，Seedance、Kling、Wan 等影片模型，以及語音、聲音複製、音效和音樂等音訊模型。執行 zooop models 查看最新清單。
要花多少錢？
CLI 本身免費。每次生成花的積分和網站上一樣，執行前用 zooop quote 就能看到確切價格。
能在 CI 或腳本裡使用嗎？
可以。設定 ZOOOP_API_KEY 取代登入，加上 --json 取得機器可讀的輸出，再檢查結束代碼：0 代表成功，1 代表 API 或任務失敗，2 代表用法錯誤。
怎麼登出或撤銷授權？
執行 zooop logout 撤銷金鑰並從電腦上刪除，或在 API 金鑰頁面撤銷。撤銷後的金鑰在任何地方都會失效。
它和 ZOOOP Agent 技能有什麼不同？
CLI 是給你自己用的：可以親手輸入指令，也可以在自己的腳本裡呼叫；技能則是教 Claude Code、Codex 這類 AI Agent 在對話裡呼叫 ZOOOP。