WaveSpeed CLI · MCP

在 Claude Code、Codex 和終端機裡生成圖片和影片

一個開源 CLI,執行任何 WaveSpeed AI 模型。圖像、影片、音訊、3D。為終端機和 Codex、Claude Code、Claude Cowork、Cursor 等編碼 agent 而設計。

CLI

@wavespeed/cli

安裝一次,即可在命令列或腳本中執行任何模型。

$npm install -g @wavespeed/cli

MCP

@wavespeed/mcp

託管 MCP 伺服器:在任何 MCP 用戶端中依位址新增並登入即可。

https://api.wavespeed.ai/mcp

在你的代理中接入 WaveSpeed

選擇你用的工具,查看最快的接入方式。每種方式都能使用完整模型庫,執行前先看價格。

Claude Code

外掛

一次安裝即可取得託管 MCP 伺服器和 WaveSpeed 技能。

  1. 1

    新增 WaveSpeed 外掛市集

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    安裝外掛

    $claude plugin install wavespeed@wavespeed
  3. 3

    在 Claude Code 中執行 /mcp,選擇 wavespeed,並在瀏覽器中核准連線

    /mcp
接著試著說: “生成一張賽博龐克城市天際線的 16:9 主視覺圖,先告訴我價格。”

其他方式

只要 MCP 伺服器,不要技能:

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

三條指令即可上線

  1. 1

    安裝

    需要 Node 18+。一次全域安裝就能在任何地方使用 wavespeed 執行檔。

    $npm install -g @wavespeed/cli
  2. 2

    登入

    在瀏覽器中開啟 access-key 頁面。我們會自動偵測剪貼簿中的金鑰並即時驗證。

    $wavespeed login
  3. 3

    執行任意模型

    所有模型形狀一致。傳入模型 ID 與輸入 — 取得 CDN URL,或將 --json 管道送入你的腳本。

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
  • 教你的程式設計代理使用 CLI

    安裝一個技能,讓 Codex、Claude Code、Cursor 等代理知道如何呼叫它。

    $wavespeed skill install
  • 沒有 Node.js?

    在 macOS 和 Linux 上可改為安裝獨立執行檔;在 Windows 上請從 GitHub Releases 下載。

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash
  • 保持最新

    一行指令升級到最新版本。

    $wavespeed upgrade
  • 在你的程式設計代理中使用 WaveSpeed 模型

    一鍵設定 Claude Code、Codex、OpenCode 等使用 WaveSpeed LLM API,隨時可還原。

    $wavespeed setup

為人類與 agent 而生

依模型動態產生說明

執行 wavespeed run <model> -h,CLI 會即時取得該模型的輸入 schema 並印出它接受的確切 flag — 無需猜測。

隨你的儲存庫一起分發的別名

在 wavespeed.json 中定義具名捷徑,把模型 + 預設輸入打包起來。團隊拉取檔案,輸入 wavespeed run hero,就能得到符合品牌的輸出。

從設計上就是 agent 原生

每條指令都在 stdout 上輸出 --json,在 stderr 上輸出進度。放一個 SKILL.md,Codex、Claude Code、Claude Cowork 與 Cursor 就知道怎麼呼叫。

沒有魔法,也沒有常駐程序

CLI 永遠不會修改你的 prompt,也不會啟動背景程序。它直接呼叫 api.wavespeed.ai。開源,MIT 授權。

真實工作階段長這樣

從瀏覽目錄到 JSON 輸出 — 三條指令。

~/projects/marketing
# 1. browse the catalog
$ wavespeed models --type text-to-image --popular

# 2. inspect a model's inputs — schema fetched live
$ wavespeed run wavespeed-ai/z-image/turbo -h
  * prompt          string
    size            string   default: "1024*1024"
    strength        number   default: 0.6   range: 0..1
    output_format   string   default: "jpeg"   enum: jpeg | png | webp

# 3. run — JSON out so you can pipe it
$ wavespeed run wavespeed-ai/z-image/turbo \
    -p "a cyberpunk skyline at golden hour" --json
{
  "model": "wavespeed-ai/z-image/turbo",
  "outputs": ["https://example.com/output/skyline.jpeg"],
  "elapsed_ms": 4718
}

在 Claude Code 和 Codex 裡生成圖片和影片

安裝一次 CLI 和配套 skill,之後直接開口就好。程式代理會幫你執行指令,並把檔案存到你的專案裡。

Claude Code · WaveSpeed CLI

幫我咖啡店的到達頁做一張 16:9 的主視覺:溫馨、日出時分,留出放標題的空間。

日出時分從街上看到的一間溫馨咖啡店

主視覺做好了:溫暖的日出光線灑在店面上,畫面夠寬,適合做橫幅。 · 花費 $0.045

generate image
$ wavespeed generate image "cozy coffee shop at sunrise, warm light in the windows, room for a headline" --aspect-ratio 16:9 --download

不錯。在前窗寫上 "Open at 7"。

同一間咖啡店,窗上寫著 "Open at 7"

完成:窗上手寫了 "Open at 7",其他地方都沒動。 · 花費 $0.045

edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --download

在程式代理裡生成圖片和影片

如何在 Claude Code 裡生成圖片?

用 npm install -g @wavespeed/cli 安裝 CLI,用 wavespeed login 登入,再用 wavespeed skill install 加入 skill。接著請 Claude Code 生成圖片,它會執行 wavespeed generate image 並把檔案存到你的專案裡。

如何在 Codex 裡生成圖片和影片?

安裝並登入 CLI,然後執行 wavespeed skill install,讓 Codex 學會這些指令。請 Codex 生成圖片或影片,它就會替你執行;也可以從 /plugins 安裝 WaveSpeed 外掛。

代理實際執行的是什麼?

都是你看得懂、也能自己重複執行的一般指令:wavespeed generate image、wavespeed edit image、wavespeed generate video。本機檔案用 @./file 傳入,結果用 --download 下載。

在 Cursor 和其他程式代理裡也能用嗎?

可以。任何能執行終端機指令的代理都能使用 CLI,skill 會教它這些指令。支援 MCP 的代理也可以改為連接託管伺服器。

也能生成影片嗎?

可以。wavespeed generate video 能根據文字、起始圖片或參考圖生成影片,wavespeed edit video 和 extend video 能修改或延長既有影片。

費用怎麼算?

按次從你的 WaveSpeed 餘額扣款,不需訂閱。加上 --estimate 可以在執行前查看價格;每個結果都會顯示實際花費。

代理透過 MCP 能做什麼

適合日常圖片和影片工作的快捷工具,加上完整模型庫:搜尋模型、查看模型的真實輸入、查詢價格,然後執行。

generate_image

依提示詞生成圖片,可附參考圖

edit_image

編輯、換風格或合成現有圖片

generate_video

依提示詞、首幀或參考素材生成影片

edit_video

修改現有影片中的內容

extend_video

用新畫面延長影片

list_models

依文字或類型搜尋即時模型目錄

get_model_schema

模型的真實輸入、必填欄位和預設值

run_model

執行任意模型;本機 @檔案 輸入會自動上傳

get_price

花錢前先報價

get_balance

查看點數餘額

upload_file

把本機檔案變成託管 URL

get_prediction

依 id 取回耗時較長的生成任務

list_predictions

查看生成歷史

list_billings

查看逐筆扣款與退款

get_usage

依日期與模型查看花費與用量

delete_predictions

從歷史記錄中刪除任務(會先徵得你的同意)

upload_file 僅本機伺服器提供。遠端伺服器讀不到你的檔案:請傳公開連結,在能傳送 HTTP 請求的工具中使用 create_upload,或在 ChatGPT 裡直接把檔案附到對話中。

開源。今天就能用。

MIT 授權,在 npm 上以 @wavespeed 範圍發布,託管在 GitHub。歡迎提交 Issue 與 PR。

更想用圖形介面?試試 WaveSpeed Desktop查看接入 WaveSpeed 的所有方式