WaveSpeed MCP · CLI

在 Claude、ChatGPT、Cursor 和 Codex 中生成圖片和影片

把 WaveSpeed 接入你正在用的 AI 代理,然後直接提出需求。它會找到合適的模型、報價並生成。只需在瀏覽器中登入一次,無需複製 API 金鑰。

一鍵接入

https://api.wavespeed.ai/mcp

WaveSpeed MCP

你可以做什麼

透過 WaveSpeed MCP 做出的真實成果。選擇你的工作環境,一鍵傳送請求或複製。

傳送管道

生成圖片

一段描述生成一張時尚大片。

Create a fashion editorial photo of a young woman standing between sculptural archways painted coral and sky blue, one hand on the curved wall. She wears a voluminous ivory gown with ruffled sleeves and tiny pearl details, her long dark hair in a single thick braid with a small white flower. Soft studio light, saturated colours, the grain of 35mm film.

在 Claude 中試試

生成影片

有聲音、有運鏡的電影感短片。

Make an 8-second video of a young man with curly hair in a yellow raincoat running up a stone seaside staircase in the rain, laughing. The handheld camera follows him to the top, where he catches his breath and looks out at a stormy sea as the wind blows his hood back. Sound of rain, waves and his breathing.

在 Claude 中試試

短劇

把你的故事變成一場戲,角色形象一致,還有台詞對白。

Turn my story into a short drama scene with a consistent cast: a gruff old lighthouse keeper finds a soaked young sailor at his door on a stormy night. First make a still of both characters, then a 10-second scene with spoken dialogue. He says: "You're lucky the light was still on." She answers: "I thought this place was empty."

在 Claude 中試試

產品評測 UGC

一張照片,生成創作者風格的產品評測。

Make a creator-style product review of my product (ask me for a photo): a friendly creator at her kitchen table holds it up to her phone and says: "Okay, I've used this bottle every day for a month. Ice lasts the whole day, and it hasn't leaked in my bag once." Vertical, handheld, natural light, about 8 seconds.

在 Claude 中試試

Claude 需要時,附上你自己的檔案。

之前
之後

廣告復刻

保留參考廣告的運鏡、節奏和氛圍,換成你的產品。

Recreate the reference ad I give you (ask me for the video) for my own product (ask me for a photo): keep its camera move, pacing, lighting and mood, but show my product instead. Tell me the price first.

在 Claude 中試試

Claude 需要時,附上你自己的檔案。

之前
之後

放大到 4K

把小而模糊的圖片變成清晰的 4K 圖片。

Upscale my image to 4K (ask me to attach it). Keep the face, colours and composition exactly as they are, just make it sharp. Use a dedicated upscaler and tell me the price first.

在 Claude 中試試

Claude 需要時,附上你自己的檔案。

之前
之後

氛圍感剪輯

為你的素材加上光暈、變速和閃白轉場,煥然一新。

Turn my footage (ask me for the video) into an aura edit: keep the person and the camera movement, add a glowing aura outline, speed-ramped slow motion, flash-frame transitions and film grain with light leaks, cut to a pulsing electronic beat.

在 Claude 中試試

Claude 需要時,附上你自己的檔案。

在你的代理中接入 WaveSpeed

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

Claude

一鍵安裝

適用於網頁版 Claude 和 Claude Desktop,無需安裝。

  1. 1

    點擊按鈕:Claude 會開啟,並已將 WaveSpeed 填好為自訂連接器。點擊 Add。

    加入 Claude
  2. 2

    依提示登入 WaveSpeed 並核准連線

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

其他方式

也可以手動新增:在 Claude 中開啟 Customize → Connectors → Add custom connector,貼上此位址。

https://api.wavespeed.ai/mcp

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

連接一次 WaveSpeed,之後直接開口就好。代理會選好工具、做出圖片,並告訴你花了多少錢。

ChatGPT · 已連接 WaveSpeed

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

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

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

generate_image · 16:9
generate_image
  prompt: cozy coffee shop at sunrise, warm light in the windows, room for a headline
  aspect_ratio: 16:9

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

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

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

edit_image
edit_image
  prompt: add the words "Open at 7" in white hand lettering on the front window
  images: [hero.jpg]

在 AI 助理裡生成圖片和影片

如何用 WaveSpeed 在 ChatGPT 裡生成圖片?

在 ChatGPT 中開啟 Plugins,選擇 Add custom MCP server,貼上 https://api.wavespeed.ai/mcp 並用你的 WaveSpeed 帳號登入。接著用白話描述想要的圖片就好,例如「做一張 16:9 的日出咖啡店主視覺」。

Claude Desktop 能生成圖片和影片嗎?

可以,只要把 WaveSpeed 新增為連接器。在 Claude(桌面版或網頁版)中開啟 Customize → Connectors → Add custom connector,貼上 https://api.wavespeed.ai/mcp 並登入。之後 Claude 就能幫你生成和編輯圖片、影片。

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

在 Codex 中開啟 /plugins,安裝 WaveSpeed,並在瀏覽器中核准連線。之後 Codex 處理你的專案時就能生成圖片和影片,並存進專案裡。

如何在 Claude Code 裡生成圖片?

新增 WaveSpeed 外掛市集並安裝外掛,然後在 Claude Code 中執行 /mcp 並核准連線。之後想要圖片或影片直接說,Claude Code 會替你呼叫 WaveSpeed。

能在同一個對話裡修改圖片,或用它做影片嗎?

可以。提出修改(「把展示台改成薄荷綠」),代理就會修改上一張圖;想要影片的話,它可以讓圖片動起來,也能直接生成一整段影片。

費用怎麼算?

按次從你的 WaveSpeed 餘額扣款,不需訂閱。代理可以在執行前告訴你價格,每個結果也都會顯示實際花費。

代理透過 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 裡直接把檔案附到對話中。

更喜歡終端機?使用 CLI

在 shell、腳本和能執行指令的代理中使用同一套模型目錄:一行開源指令涵蓋所有模型,輸出 JSON,方便透過管線處理。

CLI

@wavespeed/cli

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

$npm install -g @wavespeed/cli

三條指令即可上線

  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
}

開源。今天就能用。

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

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