WaveSpeed CLI

Every WaveSpeed model — from your terminal

One open-source CLI to run any WaveSpeed AI model. Image, video, audio, 3D. Dynamic per-model help fetched live, alias shortcuts you control, pipe-safe JSON for agents.

$npm install -g @wavespeed/cli

Install from npm View on GitHub

Three commands and you're shipping

Install

Node 18+ required. One global install gives you the wavespeed binary everywhere.

$npm install -g @wavespeed/cli

Sign in

Opens the access-key page in your browser. We auto-detect a copied key and validate it live.

$wavespeed login

Run any model

Same shape for all models. Pass the model ID and inputs — get a CDN URL back, or pipe --json to your scripts.

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

Built for humans and agents

Dynamic per-model help

Run wavespeed run '<'model'>' -h and the CLI fetches that model's input schema live and prints the exact flags it accepts — no guessing.

Aliases that ship with your repo

Define named shortcuts in wavespeed.json that bundle a model + default inputs. Teams pull the file, type wavespeed run hero, get on-brand output.

Agent-native by design

Every command supports --json on stdout and progress on stderr. Drop a SKILL.md so Claude Code, Cursor, and Codex know how to call it.

No magic, no daemon

The CLI never mutates your prompt and never opens a background process. It calls api.wavespeed.ai directly. Open source, MIT licensed.

What a real session looks like

From catalog browse to JSON output — three commands.

~/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://d2p7pg.cachecloud.net/.../skyline.jpeg"],
  "elapsed_ms": 4718
}

Plug into your coding agent in one step

No MCP server, no extra config. Coding agents already know how to run shell commands — the SKILL.md tells them how to use the CLI.

$wavespeed skill install

Works with Claude Code, Cursor, Codex, and any agent that auto-loads .claude/skills/*.

Open source. Ready today.

MIT licensed, scoped under @wavespeed on npm, hosted on GitHub. Issues and PRs welcome.

Install from npm Star on GitHub