Seedance 2.0 15% DE DESCONTO | Crie no Video Generator →

WaveSpeed CLI

Todos os modelos WaveSpeed — do seu terminal e agente

Uma CLI de código aberto para executar qualquer modelo de IA WaveSpeed. Imagem, vídeo, áudio, 3D. Criada para terminais e agentes de código como Codex, Claude Code, Claude Cowork e Cursor.

$npm install -g @wavespeed/cli

Três comandos e você está em produção

1

Instalar

Requer Node 18+. Uma instalação global deixa o binário wavespeed disponível em qualquer lugar.

$npm install -g @wavespeed/cli
2

Entrar

Abre a página de access-key no seu navegador. Detectamos uma chave copiada automaticamente e validamos ao vivo.

$wavespeed login
3

Executar qualquer modelo

Mesma forma para todos os modelos. Passe o ID do modelo e as entradas — receba uma URL de CDN, ou canalize --json para seus scripts.

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

Construída para humanos e agentes

Ajuda dinâmica por modelo

Execute wavespeed run '<'model'>' -h e a CLI busca ao vivo o esquema de entrada daquele modelo e imprime exatamente as flags que ele aceita — sem adivinhar.

Aliases que viajam com o seu repo

Defina atalhos nomeados em wavespeed.json que agrupam um modelo + entradas padrão. Os times baixam o arquivo, digitam wavespeed run hero, recebem saída alinhada à marca.

Nativa para agentes desde o design

Cada comando suporta --json em stdout e progresso em stderr. Coloque um SKILL.md para que Codex, Claude Code, Claude Cowork e Cursor saibam como chamá-la.

Sem mágica, sem daemon

A CLI nunca altera seu prompt e nunca abre processo em segundo plano. Chama api.wavespeed.ai diretamente. Código aberto, licença MIT.

Como é uma sessão de verdade

Da navegação do catálogo à saída JSON — três comandos.

~/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
}

Conecte ao seu coding agent em um passo

Sem servidor MCP, sem configuração extra. Agentes de código como Codex, Claude Code e Claude Cowork já sabem executar comandos de shell — o SKILL.md diz a eles como usar a CLI.

$wavespeed skill install

Funciona com Codex, Claude Code, Claude Cowork, Cursor e qualquer agente que carregue .claude/skills/* automaticamente.

Código aberto. Pronto hoje.

Licenciado MIT, publicado sob @wavespeed no npm, hospedado no GitHub. Issues e PRs bem-vindos.