WaveSpeed

ai.wavespeed由 wavespeed.ai 發布官方發布者v1.2.10更新於 Nov 6, 2026

Run any model on the live WaveSpeed catalog: image, video, audio, 3D.

已驗證Streamable HTTP可網頁執行媒體與設計AI 與機器學習

概覽

AI 產生的概覽

WaveSpeed MCP 讓助理呼叫 WaveSpeed 即時目錄中的影像、影片、音訊與 3D 生成模型,並可預估價格、查看執行紀錄。

可以做什麼
  • 搜尋即時模型目錄,並在執行前讀取模型的真實輸入結構
  • 執行任一目錄模型,或用快捷工具生成與編輯影像、生成、編輯與延長影片
  • 送出前預估執行費用,並查看帳戶額度餘額
  • 上傳本機檔案取得託管連結,或直接傳入會自動上傳的本機路徑
  • 查看執行歷史、依 id 取得預測狀態與輸出,並刪除已完成的執行
  • 列出逐項扣款紀錄與用量統計(花費、請求數、依模型細分)
適用情境
適合讓助理透過 WaveSpeed 模型生成或編輯媒體(影像、影片、音訊、3D),或在消耗額度前先查價格與帳戶用量。較偏向創意與內容製作,而非程式或資料處理。
執行需求
可使用託管的遠端端點並透過 OAuth 授權,或透過 npx 執行本機 npm 套件(需 Node.js)。驗證使用 WAVESPEED_API_KEY 密鑰,本機也可用已儲存的 CLI 登入;帳務類工具需要具備 Billing 權限的密鑰。可選 WAVESPEED_BASE_URL 與 WAVESPEED_CLIENT_NAME 覆寫項。託管服務無法讀取本機檔案,需傳公開連結或先上傳。
安裝前請注意
執行會消耗付費帳戶額度;get_price 僅為估算,實際扣款以帳務為準。伺服器會把本機檔案上傳到 WaveSpeed 託管,delete_predictions 會從歷史中刪除已完成的執行(軟刪除、輸出連結失效,且無法從該工具復原)。帳務與用量工具需要 Billing 權限的密鑰,應據此限制密鑰權限。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 WaveSpeed,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.wavespeed%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "wavespeed": {
      "type": "http",
      "url": "https://api.wavespeed.ai/mcp"
    }
  }
}

README

WaveSpeed MCP Server

[Add the hosted wavespeed MCP server to Cursor]

An MCP server for the WaveSpeed platform: run any model on the live catalog — image, video, audio, 3D — from Claude Code, Claude Desktop, Cursor, Cline, or any MCP client.

Built on the same design as the open-source @wavespeed/cli:

  • No hardcoded models for run_model. The catalog comes from the live API (1h cache); new platform models work the day they ship.
  • One general verb, five shortcuts. run_model executes anything; get_model_schema tells the agent what inputs a model actually accepts, so it reads before it writes. generate_image, edit_image, generate_video, edit_video and extend_video skip that: they use the same models as the WaveSpeed /chat page, pick the endpoint for what you give them and fit the request to its live schema.
  • Inputs are never mutated. The one explicit transform is the @path marker — a "@./photo.jpg" value inside input uploads the file and substitutes its hosted URL. Bare paths are passed through untouched. The shortcut tools (generate_image etc.) are the exception: they pick the endpoint and fit the request to the model, and report what they changed in notes.
  • Quote before you spend. get_price takes the same input as run_model and returns an estimate; the amount actually charged for a run is authoritative.

Tools

ToolWhat it does
list_modelsSearch the live catalog by text or modality type
get_model_schemaA model's real input schema (required, properties, defaults), with a link to the model's playground page
run_modelSubmit + wait; rejects input keys the model doesn't accept; @path inputs upload automatically; returns output URLs
generate_imageImage from a prompt with the /chat image models (default Seedream 5 Pro); reference images use the model's edit endpoint
edit_imageEdit, restyle or combine existing images with the same models
generate_videoVideo from a prompt, a first/last frame or reference images/videos/audio, with the /chat video models (default Seedance 2.5); the mode (text, image, reference) is picked from the inputs
edit_videoEdit an existing video, optionally with reference images/audio
extend_videoContinue an existing video with new footage
get_priceCost estimate for the inputs you pass (no charge), with a link to the model's playground page
get_balanceAccount credit balance, with the top-up link
list_predictionsRun history (default last 24h); filter by model, status, time range
list_billingsItemized charges and refunds (needs a Billing-access key)
get_usageSpend, request counts and per-model breakdown (default last 7 days; needs a Billing-access key)
delete_predictionsDelete finished runs from the history (up to 100; needs confirm: true, cannot be undone from here)
upload_fileLocal file → hosted URL (24h content-hash dedupe)
get_predictionStatus/outputs of any run by id; optional wait_seconds to wait for it

The five shortcut tools take wait_seconds like run_model, and estimate_only: true returns the price and the exact request that would run without submitting or charging anything. In their prompts, media is named @image 1, @video 1, @audio 1 (in the order given); it is renamed to what each model expects. Models and defaults follow /chat: an unknown model is rejected, and a named model is never switched.

Some generations take minutes to hours. run_model submits the run and returns the prediction id right away (done: false); the assistant then calls get_prediction with that id and wait_seconds (max 1800) until done is true. The task keeps running server-side, so a dropped connection loses nothing. Pass wait_seconds to run_model to wait for a quick model in the same call. While waiting, both tools send MCP progress notifications that carry the prediction id.

Setup

Remote (nothing to install)

The same server is hosted at:

text
https://api.wavespeed.ai/mcp
  • Claude on the web / ChatGPT: add a custom connector with that address and approve the connection on the WaveSpeed page that opens. Approving creates a dedicated API key (named MCP · <app>) that you can delete on the API Keys page to disconnect.

  • Claude Code: claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

  • Cursor: [Add the hosted wavespeed MCP server to Cursor]

  • VS Code: code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}'

  • Clients that only start local commands: connect through mcp-remote, which opens the same browser approval on first start:

    json
    {  "mcpServers": {    "wavespeed": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.wavespeed.ai/mcp"]    }  }}
  • Any other client that sends request headers: point it at the URL with Authorization: Bearer <your API key>.

The hosted server has the same tools, with one difference for files: it cannot read files on your computer, so pass public URLs, use create_upload from a tool that can send HTTP requests (it returns a temporary upload address and the download_url to use as an input), or, in ChatGPT, attach the file to the chat (the upload_attachment tool, which only ChatGPT can fill, imports it and returns a download_url). Full guide: wavespeed.ai/docs/mcp.

Local (npx)

@latest makes npx fetch the newest release on each start; without it, npx runs a globally installed @wavespeed/mcp if one exists, however old.

Auth resolves from WAVESPEED_API_KEY, or from the CLI's stored login (wavespeed login) — one login covers both tools. Keys: wavespeed.ai/accesskey.

Claude Code

bash
claude mcp add wavespeed -- npx -y @wavespeed/mcp@latest

Claude Desktop / other clients (mcpServers config):

json
{  "mcpServers": {    "wavespeed": {      "command": "npx",      "args": ["-y", "@wavespeed/mcp@latest"],      "env": { "WAVESPEED_API_KEY": "wsk_..." }    }  }}

Example prompts

  • "Generate a 16:9 hero image of a cyberpunk skyline at golden hour."
  • "Take ./photo.jpg and replace the background with a sunlit kitchen." (the agent passes "@./photo.jpg")
  • "Animate ./hero.png with subtle parallax — check the price first."

Development

bash
npm installnpm run dev        # run from source (stdio)npm run lint       # typechecknpm run build      # tsc → dist/

License

MIT


WaveSpeed AI — AI image & video generation platform. Try it in the browser: Image generator · Video generator

來源:README.md,提交 2510e29

工具

16

list_models

Search the live WaveSpeed model catalog (image, video, audio, 3D). Returns model IDs usable with run_model. Do not invent model IDs — always pick one returned by this tool.

輸入參數typelimitqueryrefresh

get_model_schema

Get a model's real input schema (required fields, properties, defaults). Call this before run_model so inputs match what the model actually accepts.

輸入參數model必填

run_model

Run any WaveSpeed model. input keys come from get_model_schema; unknown keys are rejected before submission. Local files: pass "@./path" in a media field (image, images, video, audio, mask …) — it is uploaded and replaced with hosted URLs (bare paths are NOT uploaded). Returns the prediction id right away (done=false); call get_prediction with that id and wait_seconds until done=true to get the output URLs. The task keeps running on the server. Pass wait_seconds here to wait for a quick model in the same call.

輸入參數input必填model必填wait_seconds

generate_image

Create an image from a text description with the same models as the WaveSpeed /chat page (seedream-5-pro, nano-banana-2.1, nano-banana-2, nano-banana-pro, gpt-image-2.6, gpt-image-2.5, gpt-image-2; default seedream-5-pro). Give reference_images to use existing images as subject, product, face or style (the model's edit endpoint is used). To change existing images use edit_image. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.

輸入參數modelprompt必填resolutionaspect_ratiowait_secondsestimate_onlyreference_images

edit_image

Change existing images with the same models as the WaveSpeed /chat page: edits, restyles, backgrounds, adding or removing things, combining several images. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.

輸入參數modelimages必填prompt必填resolutionaspect_ratiowait_secondsestimate_only

generate_video

Create a video with the same models as the WaveSpeed /chat page (default seedance-2.5). Give first_frame to animate an image; give reference_images / reference_videos / reference_audios to keep characters, products, motion, voice or music. The right mode (text, image or reference to video) is picked from what you give. Videos can cost dollars: use estimate_only first when unsure. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.

輸入參數modelprompt必填durationlast_frameresolutionfirst_frameaspect_ratiowait_secondsestimate_onlyreference_audiosreference_imagesreference_videos

edit_video

Edit an existing video with the same models as the WaveSpeed /chat page. Name the video and any references in the prompt (e.g. "replace the cat in @video 1 with the lion from @image 1"). In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.

輸入參數modelvideo必填prompt必填resolutionwait_secondsestimate_onlyreference_audiosreference_images

extend_video

Continue an existing video with new footage after its end, with the same models as the WaveSpeed /chat page. Turbo models cannot extend. In the prompt, name input media as @image 1, @image 2, @video 1, @audio 1 (counted in the order the lists are given); they are renamed to what the model expects.

輸入參數modelvideo必填prompt必填durationlast_frameresolutionwait_secondsestimate_only

get_price

Estimate the cost of a run before executing it (no charge). Provide the same input you would pass to run_model — pricing often depends on inputs like duration or resolution, and a quote made without them can be lower than the real charge.

輸入參數inputmodel必填

get_balance

Show the WaveSpeed account credit balance, with the link to top up.

無需輸入參數。

list_predictions

List past predictions (run history), newest window first. Defaults to the last 24 hours; pass since/until (ISO or YYYY-MM-DD) for other ranges. Use get_prediction with an id for one task in full.

輸入參數pagelimitmodelsinceuntilstatus

list_billings

List itemized charges and refunds (billing records). Requires an API key with Billing access.

輸入參數keypagetypelimitmodelsinceuntil

get_usage

Usage statistics: spend, request counts, daily series and per-model breakdown. Defaults to the last 7 days. Requires an API key with Billing access.

輸入參數modelsinceuntil

delete_predictions

Delete finished predictions from this account's run history, up to 100 at a time. This is a soft delete: each record stays, with status "deleted" and without its outputs, and list_predictions and get_prediction still return it that way; the output links are revoked (best effort). This tool cannot undo it. Runs that are still going are left alone, and only the key's own organization's records are deleted. Ask the user first, and pass confirm: true only after they agreed to delete these ids.

輸入參數ids必填confirm必填

upload_file

Upload a local file to WaveSpeed and get its hosted URL (identical bytes reuse the same upload for 24h). Usually unnecessary — run_model handles "@./path" inputs itself.

輸入參數path必填

get_prediction

Fetch the status and outputs of a past or in-flight prediction by id — use to pick up a run that returned done=false. Pass wait_seconds to keep waiting for it to finish.

輸入參數id必填wait_seconds

版本歷史

16
  1. v1.2.10最新Nov 6, 2026
  2. v1.2.8Nov 5, 2026
  3. v1.2.7Nov 3, 2026
  4. v1.2.6Nov 3, 2026
  5. v1.2.4Nov 1, 2026
  6. v1.2.3Nov 1, 2026
  7. v1.2.2Oct 29, 2026
  8. v1.1.0Oct 26, 2026
  9. v1.0.18Oct 21, 2026
  10. v1.0.17Oct 20, 2026
  11. v1.0.14Oct 20, 2026
  12. v1.0.12Oct 19, 2026
  13. v1.0.11Oct 19, 2026
  14. v1.0.10Oct 17, 2026
  15. v1.0.8Oct 1, 2026
  16. v1.0.7Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分