WaveSpeed CLI · MCP

Claude Code, Codex ve terminalinizden görsel ve video üretin

Herhangi bir WaveSpeed AI modelini çalıştırmak için tek bir açık kaynak CLI. Görsel, video, ses, 3D. Terminal ve Codex, Claude Code, Claude Cowork, Cursor gibi kodlama ajanları için tasarlandı.

CLI

@wavespeed/cli

Bir kez kur, her modeli kabuktan veya betiklerden çalıştır.

$npm install -g @wavespeed/cli

MCP

@wavespeed/mcp

Barındırılan MCP sunucusu: herhangi bir MCP istemcisine adresiyle ekle ve giriş yap.

https://api.wavespeed.ai/mcp

WaveSpeed'i ajanına kur

En hızlı kurulum için aracını seç. Her seçenek tüm model kataloğunu, harcamadan önce fiyatıyla birlikte sunar.

Claude Code

Eklenti

Barındırılan MCP sunucusunu ve WaveSpeed skill'ini tek kurulumda ekler.

  1. 1

    WaveSpeed marketplace'ini ekle

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

    Eklentiyi kur

    $claude plugin install wavespeed@wavespeed
  3. 3

    Claude Code'da /mcp çalıştır, wavespeed'i seç ve bağlantıyı tarayıcıda onayla

    /mcp
Sonra şunu iste: “Siberpunk bir şehir silüetinin 16:9 hero görselini yap ve önce fiyatı söyle.”

Diğer yollar

Skill olmadan yalnızca MCP sunucusu:

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

Üç komut ve canlıdasınız

  1. 1

    Yükle

    Node 18+ gerekiyor. Tek bir global kurulum wavespeed ikilisini her yerde kullanılabilir kılar.

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

    Giriş yap

    Tarayıcınızda access-key sayfasını açar. Kopyalanan anahtarı otomatik algılar ve anında doğrularız.

    $wavespeed login
  3. 3

    Herhangi bir modeli çalıştır

    Tüm modeller için aynı form. Model ID'sini ve girdileri geçin — bir CDN URL'i alın veya --json'u betiklerinize aktarın.

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
  • Kodlama ajanına CLI'yi öğret

    Codex, Claude Code, Cursor ve diğer ajanların onu nasıl çağıracağını bilmesi için bir skill kurar.

    $wavespeed skill install
  • Node.js yok mu?

    macOS ve Linux'ta bunun yerine bağımsız bir çalıştırılabilir dosya kurabilirsiniz. Windows'ta GitHub Releases sayfasından indirin.

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash
  • Güncel kalın

    Tek komutla en son sürüme yükseltin.

    $wavespeed upgrade
  • WaveSpeed modellerini kodlama ajanınızda kullanın

    Claude Code, Codex, OpenCode ve diğerlerini WaveSpeed LLM API'sini kullanacak şekilde yapılandırın. İstediğiniz zaman geri alabilirsiniz.

    $wavespeed setup

İnsanlar ve ajanlar için tasarlandı

Modele özel dinamik yardım

wavespeed run <model> -h çalıştırın, CLI o modelin girdi şemasını anında çeker ve kabul ettiği tam flag'leri yazdırır — tahmin yok.

Repo ile birlikte gezen alias’lar

wavespeed.json içinde bir modeli + varsayılan girdileri paketleyen adlandırılmış kısayollar tanımlayın. Ekipler dosyayı çeker, wavespeed run hero yazar, markaya uygun çıktıyı alır.

Tasarımından beri ajan-yerel

Her komut stdout üzerinde --json ve stderr üzerinde ilerleme destekler. Bir SKILL.md bırakın ki Codex, Claude Code, Claude Cowork ve Cursor nasıl çağıracaklarını bilsin.

Sihir yok, daemon yok

CLI prompt’unuzu asla değiştirmez ve hiçbir zaman arka plan süreci açmaz. api.wavespeed.ai’yi doğrudan çağırır. Açık kaynak, MIT lisanslı.

Gerçek bir oturum nasıl görünür

Katalog gezintisinden JSON çıktıya — üç komut.

~/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 ve Codex'ten görsel ve video üretin

CLI'ı ve skill'ini bir kez kur, sonra sadece iste. Kodlama ajanın komutları çalıştırır ve dosyaları projene kaydeder.

Claude Code · WaveSpeed CLI

Kafemin açılış sayfası için 16:9 bir hero görseli yap: sıcak, gün doğumu, başlık için de yer olsun.

Gün doğumunda sokaktan görünen sıcak bir kafe

İşte hero görselin: vitrine vuran sıcak gün doğumu ışığı, banner için geniş kadraj. · Maliyet $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

Güzel. Ön cama "Open at 7" yaz.

Camında "Open at 7" yazan aynı kafe

Tamam: "Open at 7" cama el yazısıyla yazıldı, geri kalan her şey aynı. · Maliyet $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

Kodlama ajanından görsel ve video üretmek

Claude Code'dan nasıl görsel üretirim?

CLI'ı npm install -g @wavespeed/cli ile kur, wavespeed login ile giriş yap ve skill'i wavespeed skill install ile ekle. Sonra Claude Code'dan bir görsel iste; wavespeed generate image çalıştırır ve dosyayı projene kaydeder.

Codex'ten nasıl görsel ve video üretirim?

CLI'ı kur ve giriş yap, ardından Codex komutları bilsin diye wavespeed skill install çalıştır. Codex'ten görsel ya da video iste, senin yerine çalıştırsın; ya da WaveSpeed eklentisini /plugins üzerinden kur.

Ajan aslında ne çalıştırıyor?

Okuyup tekrarlayabileceğin sıradan komutlar: wavespeed generate image, wavespeed edit image, wavespeed generate video. Yerel dosyalar @./file ile verilir, sonuçlar --download ile indirilir.

Cursor ve diğer kodlama ajanlarında çalışır mı?

Evet. Terminal komutu çalıştırabilen her ajan CLI'ı kullanabilir, skill de ona komutları öğretir. MCP destekleyen ajanlar bunun yerine barındırılan sunucuya da bağlanabilir.

Video da üretebilir miyim?

Evet. wavespeed generate video metinden, bir başlangıç görselinden veya referans görsellerden klip oluşturur; wavespeed edit video ve extend video da mevcut bir videoyu değiştirir veya devam ettirir.

Ücreti ne kadar?

Abonelik olmadan, her üretim için WaveSpeed bakiyenden ödersin. Hiçbir şey çalışmadan fiyatı görmek için --estimate ekle; her sonuç ne kadar tuttuğunu bildirir.

Ajanın MCP üzerinden neler yapabilir

Günlük görsel ve video işleri için kısayol araçları ve tüm katalog: model ara, bir modelin gerçek girdilerini oku, fiyat al, sonra çalıştır.

generate_image

Bir prompt'tan görsel oluştur, istersen referans görsellerle

edit_image

Mevcut görselleri düzenle, stilini değiştir veya birleştir

generate_video

Prompt, ilk kare veya referanslardan video oluştur

edit_video

Mevcut bir videoda olanları değiştir

extend_video

Videoyu yeni görüntülerle devam ettir

list_models

Canlı kataloğu metne veya türe göre ara

get_model_schema

Bir modelin gerçek girdileri, zorunlu alanları ve varsayılanları

run_model

Herhangi bir modeli çalıştır; yerel @dosya girdileri otomatik yüklenir

get_price

Harcamadan önce maliyeti öğren

get_balance

Kredi bakiyeni kontrol et

upload_file

Yerel bir dosyayı barındırılan bir URL'ye dönüştür

get_prediction

Uzun süren bir üretimi id'siyle yeniden al

list_predictions

Üretim geçmişinize göz atın

list_billings

Tek tek ücretleri ve iadeleri görün

get_usage

Harcamayı ve kullanımı güne ve modele göre izleyin

delete_predictions

Geçmişten çalıştırmaları sil (önce sorar)

upload_file yalnızca yerel sunucuda bulunur. Uzak sunucu dosyalarınızı okuyamaz: herkese açık URL’ler verin, HTTP isteği gönderebilen bir araçta create_upload kullanın veya ChatGPT’de dosyayı sohbete ekleyin.

Açık kaynak. Bugün hazır.

MIT lisanslı, npm'de @wavespeed altında yayımlandı, GitHub'da barındırılıyor. Issue ve PR memnuniyetle.

Grafik arayüzlü bir uygulama mı tercih edersiniz? WaveSpeed Desktop’u deneyinWaveSpeed’e bağlanmanın tüm yollarını görün