Войти

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/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
Затем попросите: “Сделай hero-картинку 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 модели и входные параметры — получите 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 — три команды.

~/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

Сделай hero-изображение 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?

Установите 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, прикрепите файл к чату.