使用手冊

第 04 期 · 開源工程 / AI Creative CLI

wonda：終端機驅動的 AI 內容生產線。

Degaus AI Wonda CLI 實戰手冊。一條 CLI 涵蓋 image、video、music、audio、editing、publishing，支援 JSON 輸出、jq 串接、credits 計費，可整合至 pipeline 與 agent 工作流。

Degaus AI 的 Wonda 把生圖、生影片、配音、譯文、寫腳本、發 IG、發 TikTok 全部包成一條 CLI。支援 JSON 輸出、jq 串接、credits 計費。對工程師而言，它是一條 AI 內容生產線；對 agent 而言，它是一個能跑、能算錢、能交付結果的後端。

degausai/wonda
星標
120
分支
19
授權
—
資料截至
閱讀時間
9 分
更新日期
開啟原始報告
最新版本
v1.18
影片編輯指令
26+
社群平台直發
5
官方維護
Active
本頁章節

01工具定位

給 pipeline 用的 AI 創作 CLI。

多數 AI 創作工具提供網頁拖拉介面，操作直覺，但不可程式化。Wonda 把整個 AI 創作流程做成 CLI：從生圖、生影片、配音樂、做語音、剪輯、轉場、字幕，一路到 Instagram、TikTok、LinkedIn、X、Reddit 直接發布，全部在終端機裡跑完。支援 JSON 輸出、可被 jq 串接、可被 agent 接管。

Wonda 是 Degaus AI 的官方 CLI，用 credits 計費。一次 wonda topup 加值，後續所有指令都從同一個帳號扣 credits。你可以隨時 wonda balance 查餘額，wonda pricing estimate 預估一次任務的費用。對工作室與 agent 來說，「能 estimate」比「能 generate」更重要，因為可以事先排預算。

命名脈絡很直接:wonda generate 是創作族群、wonda audio 是配音與譯文、wonda image 與 wonda video 是各自的編輯指令、wonda skill 管擴充技能、wonda publish 把成品直接送上 5 個社群平台。設計目標是 pipeline 優先，CI、cron、agent 都能直接接管。

  1. wonda auth login

  2. wonda topup

  3. wonda generate

  4. wonda video edit

  5. wonda audio

  6. wonda publish

The CLI for AI content creation. Generate, edit, and publish — all from your terminal.

— degausai/wonda README

02三種裝法

npm 或 Homebrew 全域安裝，三步完成設定。

Wonda 主要走 npm 與 Homebrew 兩種裝法。npm 路徑最快：一條 npm i -g @degausai/wonda 就裝好，接著 wonda auth login 開瀏覽器走 OAuth、加值 credits，即可使用。Mac 用 Homebrew 也行。

bash
# 全域裝(推薦),裝完直接有 wonda 指令
npm install -g @degausai/wonda

# 確認版本
wonda --version

Mac 偏好 Homebrew?

Degaus AI 維護自家 tap。先 brew tap 把來源加進來,再裝。升級走 brew upgrade wonda,版本鎖在你想要的點。

bash
brew tap degausai/tap
brew install wonda

登入、加值、跑第一支指令

所有指令都吃 credits。第一次必須 wonda auth login 走 OAuth，接著 wonda topup 加值，再 wonda balance 確認餘額。餘額查得到即代表帳號通了，後面可讓 agent 或 pipeline 自己跑。

bash
wonda auth login
wonda topup
wonda balance

03六大群組 · 一條 CLI

六大指令群，涵蓋 AI 內容生產的完整流程。

Wonda 的指令拆成六大群:認證、生成、編輯、音訊、發佈、技能。下面 12 張卡片把每群的代表入口列出來。所有指令都吃 credits，都能加 --quiet --fields 與 --jq 走 JSON 流水線。

Auth · 01

wonda auth login

OAuth 登入

瀏覽器走 OAuth 拿 token,後續所有指令都靠這個身份。wonda auth status 隨時查目前帳號。

Auth · 02

wonda balance / topup

Credits 錢包

統一 credits 計費。topup 加值、balance 查餘額、pricing estimate 跑任務前估價,適合接 budget guardrail。

Generate · 03

wonda generate image

出圖主管

從文字 prompt 出圖。支援風格、長寬比、批次量,輸出檔在當前工作目錄。社群素材、產品圖、Hero 圖都走這條。

Generate · 04

wonda generate video

出影片主管

文字、圖片、或影片參考都行。短片場景全包,適合做產品 reel、社群短片、產品宣傳影片。

Generate · 05

wonda generate music

配樂合成

輸入 prompt 與時長就生背景音樂。可以為影片配上節奏匹配的曲子,適合 reel、廣告 30 秒卡點素材。

Generate · 06

wonda generate text

文案引擎

為腳本、字幕、貼文文案、譯文做文字生成。可以接在影片合成前面寫旁白稿,跟 audio speech 串起來變語音稿。

Audio · 07

wonda audio speech

TTS 配音

把文字轉語音,可選聲線。配上 audio dialogue 還能做多角色對白,podcast、配音、短片旁白都能跑。

Audio · 08

wonda audio transcribe

語音轉逐字稿

把影片或音檔轉逐字稿,輸出有時碼。接在影片發佈前自動生字幕,做為 SRT 寫入再 burn-in。

Edit · 09

wonda video edit

26+ 影片操作

trim、concat、crop、resize、burn 字幕、加背景音樂、調速度、貼浮水印。做完輸出新檔，純 CLI，不需開啟剪輯軟體。

Edit · 10

wonda image edit

圖像後製

調尺寸、加文字、合成、去背、放大。配合 generate image 把素材修到能直接上社群、不用再進 Photoshop。

Publish · 11

wonda publish

5 平台直發

Instagram、TikTok、LinkedIn、X、Reddit 直接從 CLI 發布。先綁帳號、再丟檔案、加文案,送出排程或立即發。

Skill · 12

wonda skill install

技能擴充

官方 skill 市集。第三方技能裝進來即新增指令，擴充方式類似 IDE 外掛系統。

你想做什麼,用哪一條?

場景該跑的指令主要旗標
出圖 · 社群素材wonda generate image--prompt · --aspect-ratio
短片 · reelwonda generate video--prompt · --reference
旁白配音wonda audio speech--text · --voice
影片字幕wonda audio transcribe--input · --format srt
影片剪輯 · 串接wonda video edit26+ 子指令
排程社群貼文wonda publish--platform · --schedule
跑 pipeline · 接 jq任何指令--quiet · --fields · --jq

04進階密技 · POWER PATTERNS

六個高頻進階用法，來自 README 子指令結構。

以下六條均來自 README 與 wonda 的子指令結構，對應安裝後最容易被忽略的細節。掌握這些細節，可讓內容生產線從「能跑」提升到「能規模化」。所有 flag 與指令都對得上 README，沒有任何一條是推測。

用 --quiet --fields 接 jq 寫腳本

所有指令都吃 --quiet 關掉互動輸出、--fields 指定要哪些欄位、--jq 直接套 jq 過濾。跑完直接拿 ID 當下一條指令的輸入,寫 shell 腳本不用解析 prompt。

來源 · README · Output formatting

跑任務前先 pricing estimate

wonda pricing estimate 在實際跑指令前回傳預估 credits。把它包成 budget guard，超過 X credits 就 abort，可避免 agent 在無人看管時超支。production pipeline 建議必加這道閘門。

來源 · README · Pricing

video edit 26+ 子指令串成一條流

trim、concat、burn 字幕、加音樂、調速度都各是一條子指令。Pipeline 把它們串成「生影片 → trim → burn 字幕 → 加 BGM → publish」，比 GUI 剪輯軟體更可重複、更容易回頭 debug。

來源 · README · video edit

audio dialogue 多角色配音

單一聲線用 audio speech,多角色對白用 audio dialogue。給 podcast 訪談、教學影片、廣告對白都行。可以跟 generate text 串起來：AI 寫稿、AI 配音，人工只需審核節奏。

來源 · README · audio commands

publish --schedule 排程社群矩陣

wonda publish 支援排程,5 個平台都可以指定發佈時間。寫一段腳本一次生 7 天的素材、一次排好整週的時間表,小團隊不用再請社群排程工具。

來源 · README · publish

wonda skill install 擴充指令

不夠用?wonda skill install 從官方 skill 市集裝新指令。第三方 skill 進來就多新指令，適合把 Wonda 套到不在預設 6 群裡的工作流。安裝後可 wonda skill list 查看已裝項目。

來源 · README · skills

05實際走一輪

完整* pipeline 範例*：生影片到 IG 排程上線。

假設你要做一支 30 秒的產品宣傳 Reel,中文配音、燒進字幕,接著直接發 Instagram 與 TikTok。下面是真實情境改寫,跑在已經 wonda auth login 過、有 credits 餘額的 Mac 上。所有指令都用 --quiet --jq 拿 JSON，接給下一步，示範 Wonda 設計給 pipeline 使用的標準模式。

~/projects/spring-reel · zsh · wonda v1.18.0


$ ~/projects/spring-reel ›
  wonda pricing estimate generate.video --duration 30


# → estimated: 18 credits · ok to run


$ ~/projects/spring-reel ›
  VID=$(wonda generate video --prompt "spring product reel" \
         --duration 30 --quiet --jq '.id')


> [generate video]
  # → rendering · 30s · 1080×1920
  ok: → saved id $VID · video.mp4


$ ~/projects/spring-reel ›
  SCRIPT=$(wonda generate text --prompt "30s voiceover, zh-Hant" --quiet)
  wonda audio speech --text "$SCRIPT" --voice mei --out vo.mp3


> [audio speech]
  ok: → vo.mp3 · 30.4s


$ ~/projects/spring-reel ›
  wonda audio transcribe --input vo.mp3 --format srt --out captions.srt


> [audio transcribe]
  ok: → captions.srt · 12 段時碼


$ ~/projects/spring-reel ›
  wonda video edit add-audio --input video.mp4 --audio vo.mp3 --out v2.mp4
  wonda video edit burn-subtitles --input v2.mp4 --srt captions.srt --out final.mp4


> [video edit]
  ok: → final.mp4 · 配音與字幕已燒入


$ ~/projects/spring-reel ›
  wonda publish --platform instagram,tiktok --file final.mp4 \
         --caption "春季新品 · ✨" --schedule "tomorrow 09:00"


ok: → scheduled · IG 09:00 · TikTok 09:00 (UTC+8)


$ ~/projects/spring-reel ›
  wonda balance


# → remaining: 282 credits · spent: 22

六條指令，一個 shell 腳本。 生影片、配音、字幕、剪輯， 到 IG/TikTok 排程均在終端機完成。

— Wonda pipeline 範例示範

這條流程值得拆解的點

每一步都是可被 jq 接住的 JSON。--quiet --jq 直接把回應裡的 ID 抽出來,變成下一條指令的輸入。整段在 shell 腳本就跑完，cron、CI、agent、人工都能接管同一段。

**credits 是事前預估、事後扣帳。**跑指令前 pricing estimate、跑完 balance。對工作室來說代表「能算成本」，對 agent 來說代表「能踩剎車」：超過預算就 abort。

**publish 是流程的一個環節，而非收尾動作。**排程在指令尾巴，表示可一次性產 7 天素材、一次性排好整週時間表，無需額外的排程 SaaS。

06先看清楚這些

使用前需了解的限制與注意事項。

07進階路徑

整合至 cron、CI 與 agent 工作流的五條路徑。

Wonda 是一條 stateless 的 CLI。每條指令的輸出可被下一條讀取，所有指令都接受 JSON 輸入輸出，因此可漸進式整合至 cron、GitHub Actions、Make、Zapier、Claude Code 等任何能執行 shell 的環境。

進階玩法地圖

**1. 接 cron 自動發週報。**每週一早上 9 點，cron 跑一條 wonda 腳本：抓資料、生統計圖、配旁白、合成影片、發 IG 與 LinkedIn。人工只需決定是否回應留言。

**2. 把 Wonda 包進 Claude Code agent。**Claude Code 對話裡 agent 直接呼叫 wonda,你下達意圖、它跑指令、回傳結果。Wonda 變成你 agent 的「能力包」,跟 inference-sh、其他 MCP 工具併存。

**3. 把 publish 接進審稿流程。**用 --schedule 排到明天,中間給人審。沒問題就放出去，有問題在後台修改。人工保留審核權，但不需主動操作。

**4. CI 跑回歸測試。**GitHub Actions 每週跑一次 wonda generate image 的 fixed prompt，比對輸出 hash 或視覺差異，用以偵測 Degaus AI 上游模型是否有異動。

**5. credits 預算閘門當 SRE 護欄。**把 pricing estimate 包進 wrapper script,設一個月度上限。超過就 fail-fast,任何 agent 或 cron 都被同一條邊界鎖住。

最該讀的三份延伸閱讀

① github.com/degausai/wonda：README 是入口，包含完整指令清單與旗標。 ② degaus.ai：產品官網，含計費規則、credits 換算與服務條款。 ③ npm @degausai/wonda：最新版本與發佈頻率，鎖版本時需確認此處。

Wonda 把內容生產線的全部環節， 生成、剪輯、配音、發佈， 整合進一條可被腳本接管的 CLI。

— Wonda 設計定位