Vidu Q3 Pro chegou — experimente agora
Entrar

WaveSpeed CLI

Todos os modelos WaveSpeed — do seu terminal

Uma CLI de código aberto para executar qualquer modelo de IA WaveSpeed. Imagem, vídeo, áudio, 3D. Ajuda dinâmica por modelo obtida ao vivo, atalhos de alias que você controla e saída JSON segura para pipe destinada a agentes.

$npm install -g @wavespeed/cli
Instalar pelo npmVer no GitHub

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 Claude Code, Cursor e Codex 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. Os coding agents já sabem executar comandos de shell — o SKILL.md diz a eles como usar a CLI.

$wavespeed skill install

Funciona com Claude Code, Cursor, Codex 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.

Instalar pelo npmDar estrela no GitHub