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/cliTrês comandos e você está em produção
Instalar
Requer Node 18+. Uma instalação global deixa o binário wavespeed disponível em qualquer lugar.
$npm install -g @wavespeed/cliEntrar
Abre a página de access-key no seu navegador. Detectamos uma chave copiada automaticamente e validamos ao vivo.
$wavespeed loginExecutar 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.
# 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 installFunciona 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.