WaveSpeed CLI · MCP
Генерируйте изображения и видео из Claude Code, Codex и терминала
Одна open-source CLI для запуска любой AI-модели WaveSpeed. Изображения, видео, аудио, 3D. Создана для терминалов и coding-агентов вроде Codex, Claude Code, Claude Cowork и Cursor.
CLI
@wavespeed/cli
Установите один раз и запускайте любую модель из терминала или скриптов.
$npm install -g @wavespeed/cliMCP
@wavespeed/mcp
Облачный MCP-сервер: добавьте его по адресу в любом MCP-клиенте и войдите.
https://api.wavespeed.ai/mcpПодключите WaveSpeed к своему агенту
Выберите инструмент — покажем самый быстрый способ. Любой вариант даёт весь каталог моделей и цену до запуска.
Claude Code
ПлагинСтавит облачный MCP-сервер и скилл WaveSpeed за одну установку.
- 1
Добавьте маркетплейс WaveSpeed
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
Установите плагин
$claude plugin install wavespeed@wavespeed - 3
В Claude Code выполните /mcp, выберите wavespeed и подтвердите подключение в браузере
/mcp
Другие способы
Только MCP-сервер, без скилла:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
ПлагинСтавит облачный MCP-сервер и скилл WaveSpeed за одну установку.
- 1
Добавьте маркетплейс WaveSpeed
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
В Codex откройте /plugins, установите WaveSpeed и подтвердите подключение в браузере
/plugins
Другие способы
Только MCP-сервер, без скилла:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
ПлагинСтавит облачный MCP-сервер и скилл WaveSpeed за одну установку.
- 1
Добавьте плагин в opencode.json
{ "plugin": ["@wavespeed/opencode"] } - 2
Войдите и подтвердите подключение в браузере
$opencode mcp auth wavespeed
Другие способы
Только MCP-сервер, без скилла:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
В один кликПодключается к облачному MCP-серверу. Ничего устанавливать не нужно.
- 1
Нажмите кнопку и подтвердите в Cursor
Добавить в Cursor - 2
Войдите в WaveSpeed, когда попросят, и подтвердите подключение
Другие способы
Или добавьте это в mcp.json:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
Одна командаПодключается к облачному MCP-серверу. Ничего устанавливать не нужно.
- 1
Выполните в терминале
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
Войдите в WaveSpeed, когда попросят, и подтвердите подключение
Другие способы
Запустить сервер на своём компьютере:
Claude
Свой коннекторРаботает в Claude в браузере и в Claude Desktop. Ничего устанавливать не нужно.
- 1
В Claude откройте Customize → Connectors → Add custom connector
- 2
Вставьте этот адрес
https://api.wavespeed.ai/mcp - 3
Войдите в аккаунт WaveSpeed
Другие способы
Запустить сервер на своём компьютере:
ChatGPT
Свой коннекторДобавьте WaveSpeed в ChatGPT как свой MCP-сервер. Ничего устанавливать не нужно.
- 1
В ChatGPT откройте Plugins и выберите Add custom MCP server
- 2
Вставьте этот адрес, оставив /mcp в конце
https://api.wavespeed.ai/mcp - 3
Выберите OAuth и войдите в аккаунт WaveSpeed
Другие способы
ChatGPT не читает файлы с вашего компьютера: прикрепите их к чату или передайте публичные URL.
Gemini CLI
РасширениеСкилл WaveSpeed для Gemini CLI: ставится и обновляется одной командой.
- 1
Установите WaveSpeed CLI и войдите
$npm install -g @wavespeed/cli && wavespeed login - 2
Установите расширение
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
Плагин со скилломПлагин dsh, который автоматически регистрирует скилл WaveSpeed.
- 1
Установите WaveSpeed CLI и войдите
$npm install -g @wavespeed/cli && wavespeed login - 2
Добавьте плагин со скиллом
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
Другие MCP-клиенты
Облачный MCPWindsurf, Cline, GitHub Copilot, Goose и любой другой MCP-клиент: добавьте облачный сервер по адресу.
- 1
Добавьте удалённый MCP-сервер с этим адресом. Большинство клиентов затем попросит войти через браузер.
https://api.wavespeed.ai/mcp
Другие способы
Клиент не поддерживает удалённый MCP? Запустите сервер локально:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Вошли через wavespeed login? Локальный сервер использует этот вход, строку env можно убрать.
Три команды — и вы в проде
- 1
Установить
Требуется Node 18+. Одна глобальная установка делает бинарник wavespeed доступным везде.
$npm install -g @wavespeed/cli - 2
Войти
Открывает страницу access-key в браузере. Мы автоматически распознаём скопированный ключ и проверяем его в реальном времени.
$wavespeed login - 3
Запустить любую модель
Одна и та же форма для всех моделей. Передайте ID модели и входные параметры — получите URL CDN или перенаправьте --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 и другие на работу с LLM API WaveSpeed. Изменения можно отменить в любой момент.
$wavespeed setup
Создана для людей и агентов
Динамическая справка по каждой модели
Запустите wavespeed run <model> -h, и CLI получит схему ввода этой модели в реальном времени и напечатает точные флаги, которые она принимает — без догадок.
Алиасы, путешествующие вместе с вашим репо
Определите именованные ярлыки в wavespeed.json, объединяющие модель и параметры по умолчанию. Команды забирают файл, набирают wavespeed run hero и получают результат в стиле бренда.
Изначально спроектирована под агентов
Каждая команда поддерживает --json в stdout и прогресс в stderr. Положите SKILL.md, чтобы Codex, Claude Code, Claude Cowork и Cursor знали, как её вызывать.
Без магии, без демонов
CLI никогда не меняет ваш промпт и не запускает фоновых процессов. Она вызывает api.wavespeed.ai напрямую. Открытый код, лицензия MIT.
Как выглядит настоящая сессия
От просмотра каталога до вывода JSON — три команды.
# 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 один раз — и просто просите. Агент для программирования запустит команды и сохранит файлы в ваш проект.
Сделай hero-изображение 16:9 для лендинга моей кофейни: уютно, рассвет и место под заголовок.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
Вот ваше изображение: тёплый рассветный свет на витрине, широкий кадр под баннер. · Стоимость $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" на витрине.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
Готово: "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?
Установите CLI командой npm install -g @wavespeed/cli, войдите через wavespeed login и добавьте skill через wavespeed skill install. Затем попросите Claude Code сделать изображение — он выполнит wavespeed generate image и сохранит файл в ваш проект.
Как генерировать изображения и видео из Codex?
Установите CLI, войдите и выполните wavespeed skill install, чтобы Codex знал команды. Попросите Codex сделать изображение или видео — он запустит команды за вас. Либо установите плагин WaveSpeed через /plugins.
Что на самом деле запускает агент?
Обычные команды, которые можно прочитать и повторить: 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 есть только в локальном сервере. Удалённый сервер не может читать ваши файлы: передавайте публичные URL, используйте create_upload в инструменте, который умеет отправлять HTTP-запросы, или, в ChatGPT, прикрепите файл к чату.
Open source. Готово сегодня.
Лицензия MIT, опубликовано под @wavespeed на npm, размещено на GitHub. Issues и PR приветствуются.
Предпочитаете графическое приложение? Попробуйте WaveSpeed DesktopВсе способы подключить WaveSpeed