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/cliMCP
@wavespeed/mcp
Hostowany serwer MCP: dodaj go po adresie w dowolnym kliencie MCP i zaloguj się.
https://api.wavespeed.ai/mcpSkonfiguruj 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
WtyczkaDodaje hostowany serwer MCP i skill WaveSpeed w jednej instalacji.
- 1
Dodaj marketplace WaveSpeed
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
Zainstaluj wtyczkę
$claude plugin install wavespeed@wavespeed - 3
W Claude Code uruchom /mcp, wybierz wavespeed i zatwierdź połączenie w przeglądarce
/mcp
Inne sposoby
Sam serwer MCP, bez skilla:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
WtyczkaDodaje hostowany serwer MCP i skill WaveSpeed w jednej instalacji.
- 1
Dodaj marketplace WaveSpeed
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
W Codex otwórz /plugins, zainstaluj WaveSpeed i zatwierdź połączenie w przeglądarce
/plugins
Inne sposoby
Sam serwer MCP, bez skilla:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
WtyczkaDodaje hostowany serwer MCP i skill WaveSpeed w jednej instalacji.
- 1
Dodaj wtyczkę do pliku opencode.json
{ "plugin": ["@wavespeed/opencode"] } - 2
Zaloguj się i zatwierdź połączenie w przeglądarce
$opencode mcp auth wavespeed
Inne sposoby
Sam serwer MCP, bez skilla:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
Jedno kliknięcieŁączy się z hostowanym serwerem MCP. Nic nie trzeba instalować.
- 1
Kliknij przycisk i potwierdź w Cursor
Dodaj do Cursora - 2
Zaloguj się do WaveSpeed, gdy pojawi się prośba, i zatwierdź połączenie
Inne sposoby
Albo dodaj to do pliku mcp.json:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
Jedno polecenieŁączy się z hostowanym serwerem MCP. Nic nie trzeba instalować.
- 1
Uruchom to w terminalu
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
Zaloguj się do WaveSpeed, gdy pojawi się prośba, i zatwierdź połączenie
Inne sposoby
Uruchom serwer na własnym komputerze:
Claude
Własny konektorDziała w Claude w przeglądarce i w Claude Desktop. Nic nie trzeba instalować.
- 1
W Claude otwórz Customize → Connectors → Add custom connector
- 2
Wklej ten adres
https://api.wavespeed.ai/mcp - 3
Zaloguj się kontem WaveSpeed
Inne sposoby
Uruchom serwer na własnym komputerze:
ChatGPT
Własny konektorDodaj WaveSpeed do ChatGPT jako własny serwer MCP. Nic nie trzeba instalować.
- 1
W ChatGPT otwórz Plugins i wybierz Add custom MCP server
- 2
Wklej ten adres, zostawiając /mcp na końcu
https://api.wavespeed.ai/mcp - 3
Wybierz OAuth i zaloguj się kontem WaveSpeed
Inne sposoby
ChatGPT nie czyta plików z twojego komputera: dołącz je do czatu albo podaj publiczne adresy URL.
Gemini CLI
RozszerzenieZawiera skill WaveSpeed dla Gemini CLI, instalowany i aktualizowany jednym poleceniem.
- 1
Zainstaluj WaveSpeed CLI i zaloguj się
$npm install -g @wavespeed/cli && wavespeed login - 2
Zainstaluj rozszerzenie
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
Wtyczka ze skillemWtyczka dsh, która automatycznie rejestruje skill WaveSpeed.
- 1
Zainstaluj WaveSpeed CLI i zaloguj się
$npm install -g @wavespeed/cli && wavespeed login - 2
Dodaj wtyczkę ze skillem
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
Inne klienty MCP
Hostowany MCPWindsurf, Cline, GitHub Copilot, Goose i każdy inny klient MCP: dodaj hostowany serwer po adresie.
- 1
Dodaj zdalny serwer MCP z tym adresem. Większość klientów zaloguje cię potem przez przeglądarkę.
https://api.wavespeed.ai/mcp
Inne sposoby
Klient bez obsługi zdalnego MCP? Uruchom serwer lokalnie:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Logowałeś się przez wavespeed login? Lokalny serwer korzysta z tego logowania, więc linię env możesz usunąć.
Trzy polecenia i wdrażasz
- 1
Zainstaluj
Wymagany Node 18+. Jedna globalna instalacja udostępnia plik wykonywalny wavespeed wszędzie.
$npm install -g @wavespeed/cli - 2
Zaloguj się
Otwiera stronę access-key w przeglądarce. Wykrywamy skopiowany klucz automatycznie i walidujemy go na żywo.
$wavespeed login - 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 installNie 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 | bashBądź na bieżąco
Zaktualizuj do najnowszej wersji jednym poleceniem.
$wavespeed upgradeUż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.
# 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.
Zrób obraz hero 16:9 na landing page mojej kawiarni: przytulnie, wschód słońca, z miejscem na nagłówek.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
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 --downloadSuper. Napisz "Open at 7" na witrynie.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
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 --downloadGenerowanie 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_imageUtwórz obraz z promptu, opcjonalnie na podstawie obrazów referencyjnych
edit_imageEdytuj, zmieniaj styl lub łącz istniejące obrazy
generate_videoUtwórz wideo z promptu, pierwszej klatki lub referencji
edit_videoZmień to, co dzieje się w istniejącym wideo
extend_videoPrzedłuż wideo o nowe ujęcia
list_modelsPrzeszukuj katalog na żywo po tekście lub typie
get_model_schemaPrawdziwe wejścia, pola wymagane i wartości domyślne modelu
run_modelUruchom dowolny model; lokalne wejścia @plik są przesyłane automatycznie
get_pricePoznaj koszt, zanim wydasz
get_balanceSprawdź saldo kredytów
upload_fileZamień plik lokalny na hostowany URL
get_predictionWróć do długiej generacji po jej id
list_predictionsPrzeglądaj historię swoich generacji
list_billingsZobacz szczegółowe opłaty i zwroty
get_usageSprawdź wydatki i zużycie według dnia i modelu
delete_predictionsUsuwanie 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