WaveSpeed CLI · MCP

Generuj obrazy i wideo z Claude Code, Codex i terminala

Jeden otwartoźródłowy CLI do uruchamiania dowolnego modelu AI WaveSpeed. Obraz, wideo, dźwięk, 3D. Stworzony dla terminali i agentów kodowania takich jak Codex, Claude Code, Claude Cowork i Cursor.

CLI

@wavespeed/cli

Zainstaluj raz i uruchamiaj dowolny model z powłoki lub skryptów.

$npm install -g @wavespeed/cli

MCP

@wavespeed/mcp

Hostowany serwer MCP: dodaj go po adresie w dowolnym kliencie MCP i zaloguj się.

https://api.wavespeed.ai/mcp

Skonfiguruj WaveSpeed w swoim agencie

Wybierz narzędzie, a pokażemy najszybszą konfigurację. Każda opcja daje pełny katalog modeli z ceną przed wydaniem środków.

Claude Code

Wtyczka

Dodaje hostowany serwer MCP i skill WaveSpeed w jednej instalacji.

  1. 1

    Dodaj marketplace WaveSpeed

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    Zainstaluj wtyczkę

    $claude plugin install wavespeed@wavespeed
  3. 3

    W Claude Code uruchom /mcp, wybierz wavespeed i zatwierdź połączenie w przeglądarce

    /mcp
Potem poproś: “Zrób obraz hero 16:9 z cyberpunkową panoramą miasta i najpierw podaj cenę.”

Inne sposoby

Sam serwer MCP, bez skilla:

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

Trzy polecenia i wdrażasz

  1. 1

    Zainstaluj

    Wymagany Node 18+. Jedna globalna instalacja udostępnia plik wykonywalny wavespeed wszędzie.

    $npm install -g @wavespeed/cli
  2. 2

    Zaloguj się

    Otwiera stronę access-key w przeglądarce. Wykrywamy skopiowany klucz automatycznie i walidujemy go na żywo.

    $wavespeed login
  3. 3

    Uruchom dowolny model

    Ten sam kształt dla wszystkich modeli. Podaj ID modelu i wejścia — otrzymaj URL CDN lub przekieruj --json do swoich skryptów.

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
  • Naucz agenta obsługi CLI

    Instaluje skill, dzięki któremu Codex, Claude Code, Cursor i inne agenty wiedzą, jak z niej korzystać.

    $wavespeed skill install
  • Nie masz Node.js?

    W systemach macOS i Linux możesz zainstalować samodzielny plik wykonywalny. W systemie Windows pobierz go z GitHub Releases.

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash
  • Bądź na bieżąco

    Zaktualizuj do najnowszej wersji jednym poleceniem.

    $wavespeed upgrade
  • Używaj modeli WaveSpeed w swoim agencie programistycznym

    Skonfiguruj Claude Code, Codex, OpenCode i inne, aby korzystały z API LLM WaveSpeed. W każdej chwili możesz to cofnąć.

    $wavespeed setup

Stworzone dla ludzi i agentów

Dynamiczna pomoc dla każdego modelu

Uruchom wavespeed run <model> -h, a CLI pobierze na żywo schemat wejścia tego modelu i wypisze dokładne flagi, które akceptuje — bez zgadywania.

Aliasy podróżujące z twoim repo

Zdefiniuj nazwane skróty w wavespeed.json łączące model + domyślne wejścia. Zespoły pobierają plik, wpisują wavespeed run hero i otrzymują wynik zgodny z marką.

Natywne dla agentów z projektu

Każde polecenie obsługuje --json na stdout i postęp na stderr. Dodaj plik SKILL.md, by Codex, Claude Code, Claude Cowork i Cursor wiedziały, jak je wywołać.

Bez magii, bez demona

CLI nigdy nie modyfikuje twojego promptu i nie otwiera procesu w tle. Woła api.wavespeed.ai bezpośrednio. Open source, licencja MIT.

Jak wygląda prawdziwa sesja

Od przeglądania katalogu po wynik JSON — trzy polecenia.

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

Generuj obrazy i wideo z Claude Code i Codex

Zainstaluj CLI i jej skill raz, a potem po prostu proś. Twój agent programistyczny uruchomi polecenia i zapisze pliki w Twoim projekcie.

Claude Code · WaveSpeed CLI

Zrób obraz hero 16:9 na landing page mojej kawiarni: przytulnie, wschód słońca, z miejscem na nagłówek.

Przytulna kawiarnia o wschodzie słońca widziana z ulicy

Oto Twój obraz hero: ciepłe światło wschodu słońca na witrynie, szerokie kadrowanie pod baner. · Koszt $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

Super. Napisz "Open at 7" na witrynie.

Ta sama kawiarnia z napisem "Open at 7" na szybie

Gotowe: "Open at 7" jest ręcznie wymalowane na szybie, reszta bez zmian. · Koszt $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

Generowanie obrazów i wideo z agenta programistycznego

Jak generować obrazy z Claude Code?

Zainstaluj CLI poleceniem npm install -g @wavespeed/cli, zaloguj się przez wavespeed login i dodaj skill przez wavespeed skill install. Potem poproś Claude Code o obraz; uruchomi wavespeed generate image i zapisze plik w Twoim projekcie.

Jak generować obrazy i wideo z Codex?

Zainstaluj CLI, zaloguj się i uruchom wavespeed skill install, aby Codex znał polecenia. Poproś Codex o obraz lub wideo, a uruchomi je za Ciebie — albo zainstaluj wtyczkę WaveSpeed z /plugins.

Co właściwie uruchamia agent?

Zwykłe polecenia, które możesz przeczytać i powtórzyć: wavespeed generate image, wavespeed edit image, wavespeed generate video. Pliki lokalne przekazuje się przez @./file, a wyniki pobiera przez --download.

Czy działa to w Cursor i innych agentach programistycznych?

Tak. Każdy agent, który potrafi uruchamiać polecenia w terminalu, może używać CLI, a skill uczy go poleceń. Agenci obsługujący MCP mogą też zamiast tego połączyć się z hostowanym serwerem.

Czy mogę też generować wideo?

Tak. wavespeed generate video tworzy klip z tekstu, obrazu startowego lub obrazów referencyjnych, a wavespeed edit video i extend video zmieniają lub przedłużają istniejące wideo.

Ile to kosztuje?

Płacisz za każdą generację z salda WaveSpeed, bez subskrypcji. Dodaj --estimate, aby zobaczyć cenę, zanim cokolwiek się uruchomi; każdy wynik podaje, ile kosztował.

Co twój agent może zrobić przez MCP

Skróty do codziennej pracy z obrazem i wideo oraz pełny katalog: wyszukaj modele, sprawdź ich rzeczywiste wejścia, poznaj cenę i uruchom.

generate_image

Utwórz obraz z promptu, opcjonalnie na podstawie obrazów referencyjnych

edit_image

Edytuj, zmieniaj styl lub łącz istniejące obrazy

generate_video

Utwórz wideo z promptu, pierwszej klatki lub referencji

edit_video

Zmień to, co dzieje się w istniejącym wideo

extend_video

Przedłuż wideo o nowe ujęcia

list_models

Przeszukuj katalog na żywo po tekście lub typie

get_model_schema

Prawdziwe wejścia, pola wymagane i wartości domyślne modelu

run_model

Uruchom dowolny model; lokalne wejścia @plik są przesyłane automatycznie

get_price

Poznaj koszt, zanim wydasz

get_balance

Sprawdź saldo kredytów

upload_file

Zamień plik lokalny na hostowany URL

get_prediction

Wróć do długiej generacji po jej id

list_predictions

Przeglądaj historię swoich generacji

list_billings

Zobacz szczegółowe opłaty i zwroty

get_usage

Sprawdź wydatki i zużycie według dnia i modelu

delete_predictions

Usuwanie uruchomień z historii (najpierw pyta)

upload_file jest dostępne tylko na serwerze lokalnym. Serwer zdalny nie może czytać Twoich plików: podaj publiczne adresy URL, użyj create_upload w narzędziu, które potrafi wysyłać żądania HTTP, albo w ChatGPT dołącz plik do czatu.

Open source. Gotowe dziś.

Licencja MIT, opublikowane pod @wavespeed na npm, hostowane na GitHub. Issues i PR mile widziane.

Wolisz aplikację graficzną? Wypróbuj WaveSpeed DesktopZobacz wszystkie sposoby połączenia z WaveSpeed