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 的所有方式