サインイン

WaveSpeed CLI · MCP

Claude Code、Codex、ターミナルで画像と動画を生成

あらゆる WaveSpeed AI モデルを実行するためのオープンソース CLI。画像、動画、音声、3D。Codex、Claude Code、Claude Cowork、Cursor などのターミナルとコーディングエージェント向けに設計されています。

CLI

@wavespeed/cli

一度入れれば、シェルやスクリプトから任意のモデルを実行できます。

$npm install -g @wavespeed/cli
npm からインストールGitHub で見る

MCP

@wavespeed/mcp

ホスト型 MCP サーバー：どの MCP クライアントでもアドレスを追加してサインインするだけ。

https://api.wavespeed.ai/mcp
エージェントを選ぶGitHub で見る

エージェントに 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
あとは頼むだけ: “サイバーパンクな街並みの 16:9 ヒーロー画像を作って。先に料金を教えて。”

その他の方法

スキルなしで MCP サーバーだけ使う場合:

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

3 つのコマンドで出荷

  1. 1

    インストール

    Node 18+ が必要です。1 回のグローバルインストールで wavespeed バイナリがどこでも使えるようになります。

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

    サインイン

    ブラウザでアクセスキーのページが開きます。クリップボードのキーを自動検出し、その場で検証します。

    $wavespeed login
  3. 3

    任意のモデルを実行

    すべてのモデルが同じ形式。モデル ID と入力を渡せば、CDN URL が返ってくるか、--json をスクリプトにパイプできます。

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"

  • コーディングエージェントに CLI を教える

    スキルをインストールして、Codex、Claude Code、Cursor などのエージェントが CLI を呼び出せるようにします。

    $wavespeed skill install

  • Node.js がありませんか？

    macOS と Linux では、代わりにスタンドアロンの実行ファイルをインストールできます。Windows では GitHub Releases からダウンロードしてください。

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash

  • 常に最新に

    コマンド1つで最新バージョンにアップグレードできます。

    $wavespeed upgrade

  • コーディングエージェントで WaveSpeed のモデルを使う

    Claude Code、Codex、OpenCode などが WaveSpeed LLM API を使うように設定します。いつでも元に戻せます。

    $wavespeed setup

人間とエージェントの両方のために

モデルごとの動的ヘルプ

wavespeed run <model> -h を実行すると、CLI がそのモデルの入力スキーマをライブで取得し、受け付ける正確なフラグを表示します — 当てずっぽうは不要です。

リポジトリと一緒に運ばれるエイリアス

wavespeed.json に名前付きショートカットを定義し、モデルとデフォルト入力をまとめます。チームがファイルを取得して wavespeed run hero と入力すれば、ブランドに沿った出力が得られます。

エージェント・ネイティブな設計

すべてのコマンドが stdout の --json と stderr の進行状況をサポート。SKILL.md を配置すれば、Codex、Claude Code、Claude Cowork、Cursor が呼び出し方を理解します。

マジックも常駐プロセスもなし

CLI はあなたのプロンプトを書き換えず、バックグラウンドプロセスも開きません。api.wavespeed.ai を直接呼び出します。オープンソース、MIT ライセンス。

実際のセッションの様子

カタログ閲覧から JSON 出力まで — 3 つのコマンドで完結。

~/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 とスキルを一度インストールすれば、あとは頼むだけ。コーディングエージェントがコマンドを実行し、ファイルをプロジェクトに保存します。

Claude Code · WaveSpeed CLI

カフェのランディングページ用に 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 で画像を生成するには？

npm install -g @wavespeed/cli で CLI をインストールし、wavespeed login でサインイン、wavespeed skill install でスキルを追加します。あとは Claude Code に画像を頼めば、wavespeed generate image を実行してファイルをプロジェクトに保存します。

Codex で画像や動画を生成するには？

CLI をインストールしてサインインし、wavespeed skill install を実行して Codex にコマンドを覚えさせます。Codex に画像や動画を頼めば代わりに実行してくれます。/plugins から WaveSpeed プラグインをインストールすることもできます。

エージェントは実際に何を実行しているのですか？

読んでそのまま繰り返せる、ふつうのコマンドです：wavespeed generate image、wavespeed edit image、wavespeed generate video。ローカルファイルは @./file で渡し、結果は --download でダウンロードします。

Cursor やほかのコーディングエージェントでも使えますか？

はい。ターミナルコマンドを実行できるエージェントなら CLI を使え、スキルがコマンドを教えます。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 を渡すか、HTTP リクエストを送れるツールで create_upload を使うか、ChatGPT ではファイルをチャットに添付してください。

GitHubnpmドキュメント

オープンソース。今すぐ使えます。

MIT ライセンス、npm 上では @wavespeed スコープで公開、GitHub でホスト。Issue と PR を歓迎します。

CLInpm からインストールGitHub でスター
MCPエージェントを選ぶGitHub でスター

グラフィカルなアプリがお好みですか？WaveSpeed Desktop をお試しくださいWaveSpeed への接続方法をすべて見る

Seedream 5.5 公開中 | 画像ジェネレーターで試す →