WaveSpeed CLI · MCP
Buat gambar dan video dari Claude Code, Codex, dan terminal kamu
Satu CLI sumber terbuka untuk menjalankan model AI WaveSpeed mana pun. Gambar, video, audio, 3D. Dibuat untuk terminal dan agen coding seperti Codex, Claude Code, Claude Cowork, dan Cursor.
CLI
@wavespeed/cli
Pasang sekali, jalankan model apa pun dari shell atau skrip.
$npm install -g @wavespeed/cliMCP
@wavespeed/mcp
Server MCP terkelola: tambahkan lewat alamatnya di klien MCP mana pun, lalu masuk.
https://api.wavespeed.ai/mcpSiapkan WaveSpeed di agen Anda
Pilih alat Anda untuk penyiapan tercepat. Setiap opsi mendapat katalog model lengkap, dengan harga sebelum Anda membayar.
Claude Code
PluginMenambahkan server MCP terkelola dan skill WaveSpeed dalam satu instalasi.
- 1
Tambahkan marketplace WaveSpeed
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
Pasang plugin
$claude plugin install wavespeed@wavespeed - 3
Di Claude Code, jalankan /mcp, pilih wavespeed, lalu setujui koneksi di browser
/mcp
Cara lain
Hanya server MCP, tanpa skill:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
PluginMenambahkan server MCP terkelola dan skill WaveSpeed dalam satu instalasi.
- 1
Tambahkan marketplace WaveSpeed
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
Di Codex, buka /plugins, pasang WaveSpeed, lalu setujui koneksi di browser
/plugins
Cara lain
Hanya server MCP, tanpa skill:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
PluginMenambahkan server MCP terkelola dan skill WaveSpeed dalam satu instalasi.
- 1
Tambahkan plugin ke opencode.json Anda
{ "plugin": ["@wavespeed/opencode"] } - 2
Masuk dan setujui koneksi di browser
$opencode mcp auth wavespeed
Cara lain
Hanya server MCP, tanpa skill:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
Sekali klikTerhubung ke server MCP terkelola. Tidak ada yang perlu dipasang.
- 1
Klik tombolnya dan konfirmasi di Cursor
Tambahkan ke Cursor - 2
Masuk ke WaveSpeed saat diminta dan setujui koneksi
Cara lain
Atau tambahkan ini ke mcp.json Anda:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
Satu perintahTerhubung ke server MCP terkelola. Tidak ada yang perlu dipasang.
- 1
Jalankan ini di terminal
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
Masuk ke WaveSpeed saat diminta dan setujui koneksi
Cara lain
Jalankan server di komputer Anda sendiri:
Claude
Konektor kustomBerfungsi di Claude versi web dan Claude Desktop. Tidak ada yang perlu dipasang.
- 1
Di Claude, buka Customize → Connectors → Add custom connector
- 2
Tempel alamat ini
https://api.wavespeed.ai/mcp - 3
Masuk dengan akun WaveSpeed Anda
Cara lain
Jalankan server di komputer Anda sendiri:
ChatGPT
Konektor kustomTambahkan WaveSpeed ke ChatGPT sebagai server MCP kustom. Tidak ada yang perlu dipasang.
- 1
Di ChatGPT, buka Plugins lalu pilih Add custom MCP server
- 2
Tempel alamat ini, biarkan /mcp di akhir
https://api.wavespeed.ai/mcp - 3
Pilih OAuth dan masuk dengan akun WaveSpeed Anda
Cara lain
ChatGPT tidak bisa membaca file di komputer Anda: lampirkan ke chat atau berikan URL publik.
Gemini CLI
EkstensiBerisi skill WaveSpeed untuk Gemini CLI, dipasang dan diperbarui dengan satu perintah.
- 1
Pasang WaveSpeed CLI dan masuk
$npm install -g @wavespeed/cli && wavespeed login - 2
Pasang ekstensi
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
Plugin skillPlugin dsh yang mendaftarkan skill WaveSpeed secara otomatis.
- 1
Pasang WaveSpeed CLI dan masuk
$npm install -g @wavespeed/cli && wavespeed login - 2
Tambahkan plugin skill
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
Klien MCP lain
MCP terkelolaWindsurf, Cline, GitHub Copilot, Goose, dan klien MCP lainnya: tambahkan server terkelola lewat alamatnya.
- 1
Tambahkan server MCP jarak jauh dengan alamat ini. Sebagian besar klien lalu meminta Anda masuk lewat browser.
https://api.wavespeed.ai/mcp
Cara lain
Klien tidak mendukung MCP jarak jauh? Jalankan server secara lokal:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Sudah masuk dengan wavespeed login? Server lokal memakai login itu, jadi baris env bisa dihapus.
Tiga perintah dan Anda siap merilis
- 1
Pasang
Membutuhkan Node 18+. Satu pemasangan global memberi Anda biner wavespeed di mana saja.
$npm install -g @wavespeed/cli - 2
Masuk
Membuka halaman access-key di peramban Anda. Kami mendeteksi kunci yang disalin secara otomatis dan memvalidasinya secara langsung.
$wavespeed login - 3
Jalankan model apa pun
Bentuk yang sama untuk semua model. Berikan ID model dan input — dapatkan URL CDN, atau alirkan --json ke skrip Anda.
$wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
Ajari agen coding Anda memakai CLI
Memasang skill agar Codex, Claude Code, Cursor, dan agen lain tahu cara memanggilnya.
$wavespeed skill installTidak punya Node.js?
Di macOS dan Linux, Anda dapat memasang berkas eksekusi mandiri. Di Windows, unduh dari GitHub Releases.
$curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bashTetap terbaru
Tingkatkan ke versi terbaru dengan satu perintah.
$wavespeed upgradeGunakan model WaveSpeed di agen coding Anda
Konfigurasikan Claude Code, Codex, OpenCode, dan lainnya agar memakai API LLM WaveSpeed. Dapat dibatalkan kapan saja.
$wavespeed setup
Dibuat untuk manusia dan agen
Bantuan dinamis per model
Jalankan wavespeed run <model> -h dan CLI akan mengambil skema input model tersebut secara langsung dan mencetak flag yang tepat — tanpa menebak-nebak.
Alias yang ikut bersama repo Anda
Definisikan pintasan bernama di wavespeed.json yang menggabungkan model + input default. Tim menarik file, mengetik wavespeed run hero, mendapatkan output sesuai merek.
Asli untuk agen sejak desain
Setiap perintah mendukung --json di stdout dan progres di stderr. Letakkan SKILL.md agar Codex, Claude Code, Claude Cowork, dan Cursor tahu cara memanggilnya.
Tanpa sihir, tanpa daemon
CLI tidak pernah mengubah prompt Anda dan tidak pernah membuka proses latar belakang. Ia memanggil api.wavespeed.ai secara langsung. Sumber terbuka, berlisensi MIT.
Seperti apa sesi nyata terlihat
Dari menelusuri katalog hingga output JSON — tiga perintah.
# 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
}Buat gambar dan video dari Claude Code dan Codex
Pasang CLI dan skill-nya sekali, lalu tinggal minta. Agen coding kamu menjalankan perintahnya dan menyimpan file di proyekmu.
Buatkan gambar hero 16:9 untuk landing page kedai kopiku: hangat, suasana matahari terbit, dan ada ruang untuk judul.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
Ini gambar hero-mu: cahaya hangat matahari terbit di depan toko, dibingkai lebar untuk banner. · Biaya $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 --downloadKeren. Tulis "Open at 7" di jendela depan.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
Beres: "Open at 7" ditulis tangan di jendela, yang lain tetap sama. · Biaya $0.045
edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --downloadMembuat gambar dan video dari agen coding kamu
Bagaimana cara membuat gambar dari Claude Code?
Pasang CLI dengan npm install -g @wavespeed/cli, masuk dengan wavespeed login, lalu tambahkan skill dengan wavespeed skill install. Kemudian minta gambar ke Claude Code; ia akan menjalankan wavespeed generate image dan menyimpan file di proyekmu.
Bagaimana cara membuat gambar dan video dari Codex?
Pasang dan masuk ke CLI, lalu jalankan wavespeed skill install supaya Codex tahu perintahnya. Minta gambar atau video ke Codex dan ia akan menjalankannya untukmu, atau pasang plugin WaveSpeed dari /plugins.
Apa yang sebenarnya dijalankan agen?
Perintah biasa yang bisa kamu baca dan ulangi: wavespeed generate image, wavespeed edit image, wavespeed generate video. File lokal diberikan dengan @./file dan hasilnya diunduh dengan --download.
Apakah bisa di Cursor dan agen coding lainnya?
Bisa. Agen apa pun yang bisa menjalankan perintah terminal dapat memakai CLI, dan skill-nya mengajarkan perintah-perintahnya. Agen yang mendukung MCP juga bisa terhubung ke server yang di-hosting.
Bisa membuat video juga?
Bisa. wavespeed generate video membuat klip dari teks, gambar awal, atau gambar referensi, sedangkan wavespeed edit video dan extend video mengubah atau melanjutkan video yang sudah ada.
Berapa biayanya?
Kamu membayar per pembuatan dari saldo WaveSpeed, tanpa langganan. Tambahkan --estimate untuk melihat harga sebelum apa pun dijalankan; setiap hasil mencantumkan biayanya.
Yang bisa dilakukan agen Anda lewat MCP
Alat pintas untuk pekerjaan gambar dan video sehari-hari, plus katalog lengkap: cari model, baca input aslinya, cek harga, lalu jalankan.
generate_imageBuat gambar dari prompt, opsional dengan gambar referensi
edit_imageEdit, ubah gaya, atau gabungkan gambar yang ada
generate_videoBuat video dari prompt, frame pertama, atau referensi
edit_videoUbah apa yang terjadi di video yang ada
extend_videoLanjutkan video dengan cuplikan baru
list_modelsCari katalog langsung berdasarkan teks atau jenis
get_model_schemaInput asli, kolom wajib, dan nilai bawaan sebuah model
run_modelJalankan model apa pun; input @file lokal diunggah otomatis
get_priceLihat biaya sebelum memakai kredit
get_balanceCek saldo kredit Anda
upload_fileUbah file lokal menjadi URL yang di-hosting
get_predictionLanjutkan generasi yang lama berdasarkan id-nya
list_predictionsLihat riwayat generasi Anda
list_billingsLihat rincian tagihan dan pengembalian dana
get_usagePantau pengeluaran dan penggunaan per hari dan model
delete_predictionsHapus proses dari riwayat (bertanya dulu)
upload_file hanya ada di server lokal. Server jarak jauh tidak dapat membaca file Anda: gunakan URL publik, pakai create_upload dari alat yang dapat mengirim permintaan HTTP, atau di ChatGPT lampirkan file ke percakapan.
Sumber terbuka. Siap hari ini.
Berlisensi MIT, di-scope di bawah @wavespeed di npm, di-host di GitHub. Issues dan PR diterima.
Lebih suka aplikasi grafis? Coba WaveSpeed DesktopLihat semua cara menghubungkan WaveSpeed