WaveSpeed CLI · MCP
Gere imagens e vídeos a partir do Claude Code, do Codex e do seu terminal
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.
CLI
@wavespeed/cli
Instale uma vez e rode qualquer modelo pelo terminal ou por scripts.
$npm install -g @wavespeed/cliMCP
@wavespeed/mcp
Servidor MCP hospedado: adicione pelo endereço em qualquer cliente MCP e entre.
https://api.wavespeed.ai/mcpConfigure o WaveSpeed no seu agente
Escolha sua ferramenta para a configuração mais rápida. Todas as opções dão acesso ao catálogo completo, com o preço antes de gastar.
Claude Code
PluginAdiciona o servidor MCP hospedado e a skill do WaveSpeed numa única instalação.
- 1
Adicione o marketplace do WaveSpeed
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
Instale o plugin
$claude plugin install wavespeed@wavespeed - 3
No Claude Code, rode /mcp, escolha wavespeed e aprove a conexão no navegador
/mcp
Outras formas
Só o servidor MCP, sem a skill:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
PluginAdiciona o servidor MCP hospedado e a skill do WaveSpeed numa única instalação.
- 1
Adicione o marketplace do WaveSpeed
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
No Codex, abra /plugins, instale o WaveSpeed e aprove a conexão no navegador
/plugins
Outras formas
Só o servidor MCP, sem a skill:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
PluginAdiciona o servidor MCP hospedado e a skill do WaveSpeed numa única instalação.
- 1
Adicione o plugin ao seu opencode.json
{ "plugin": ["@wavespeed/opencode"] } - 2
Entre e aprove a conexão no navegador
$opencode mcp auth wavespeed
Outras formas
Só o servidor MCP, sem a skill:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
Um cliqueConecta ao servidor MCP hospedado. Nada para instalar.
- 1
Clique no botão e confirme no Cursor
Adicionar ao Cursor - 2
Entre no WaveSpeed quando solicitado e aprove a conexão
Outras formas
Ou adicione isto ao seu mcp.json:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
Um comandoConecta ao servidor MCP hospedado. Nada para instalar.
- 1
Rode isto no terminal
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
Entre no WaveSpeed quando solicitado e aprove a conexão
Outras formas
Rode o servidor na sua própria máquina:
Claude
Conector personalizadoFunciona no Claude na web e no Claude Desktop. Nada para instalar.
- 1
No Claude, abra Customize → Connectors → Add custom connector
- 2
Cole este endereço
https://api.wavespeed.ai/mcp - 3
Entre com sua conta WaveSpeed
Outras formas
Rode o servidor na sua própria máquina:
ChatGPT
Conector personalizadoAdicione o WaveSpeed ao ChatGPT como servidor MCP personalizado. Nada para instalar.
- 1
No ChatGPT, abra Plugins e escolha Add custom MCP server
- 2
Cole este endereço mantendo /mcp no final
https://api.wavespeed.ai/mcp - 3
Escolha OAuth e entre com sua conta WaveSpeed
Outras formas
O ChatGPT não lê arquivos do seu computador: anexe-os ao chat ou passe URLs públicas.
Gemini CLI
ExtensãoInclui a skill do WaveSpeed para o Gemini CLI, instalada e atualizada com um comando.
- 1
Instale a CLI do WaveSpeed e entre
$npm install -g @wavespeed/cli && wavespeed login - 2
Instale a extensão
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
Plugin de skillUm plugin do dsh que registra a skill do WaveSpeed automaticamente.
- 1
Instale a CLI do WaveSpeed e entre
$npm install -g @wavespeed/cli && wavespeed login - 2
Adicione o plugin de skill
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
Outros clientes MCP
MCP hospedadoWindsurf, Cline, GitHub Copilot, Goose e qualquer outro cliente MCP: adicione o servidor hospedado pelo endereço.
- 1
Adicione um servidor MCP remoto com este endereço. A maioria dos clientes pede login pelo navegador.
https://api.wavespeed.ai/mcp
Outras formas
Cliente sem suporte a MCP remoto? Rode o servidor localmente:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Entrou com wavespeed login? O servidor local usa esse login, então você pode remover a linha env.
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"
Ensine a CLI ao seu agente
Instala uma skill para que Codex, Claude Code, Cursor e outros agentes saibam como usá-la.
$wavespeed skill installNão tem Node.js?
No macOS e no Linux, você pode instalar um executável independente. No Windows, baixe-o em GitHub Releases.
$curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bashMantenha-se atualizado
Atualize para a versão mais recente com um único comando.
$wavespeed upgradeUse os modelos da WaveSpeed no seu agente de programação
Configure o Claude Code, o Codex, o OpenCode e outros para usar a API LLM da WaveSpeed. Desfaça quando quiser.
$wavespeed setup
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://example.com/output/skyline.jpeg"],
"elapsed_ms": 4718
}Gere imagens e vídeos a partir do Claude Code e do Codex
Instale a CLI e a skill dela uma vez e depois é só pedir. Seu agente de código executa os comandos e salva os arquivos no seu projeto.
Faça uma imagem hero 16:9 para a landing page da minha cafeteria: aconchegante, ao nascer do sol, com espaço para um título.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
Aqui está sua imagem hero: luz quente do nascer do sol na fachada, com enquadramento amplo para um banner. · Custo $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 --downloadLegal. Escreva "Open at 7" na vitrine.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
Pronto: "Open at 7" está pintado à mão na vitrine, o resto ficou igual. · Custo $0.045
edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --downloadGerando imagens e vídeos com seu agente de código
Como gero imagens a partir do Claude Code?
Instale a CLI com npm install -g @wavespeed/cli, entre com wavespeed login e adicione a skill com wavespeed skill install. Depois peça uma imagem ao Claude Code; ele executa wavespeed generate image e salva o arquivo no seu projeto.
Como gero imagens e vídeos a partir do Codex?
Instale a CLI, entre e execute wavespeed skill install para que o Codex conheça os comandos. Peça ao Codex uma imagem ou um vídeo e ele executa para você, ou instale o plugin do WaveSpeed em /plugins.
O que o agente executa de fato?
Comandos simples que você pode ler e repetir: wavespeed generate image, wavespeed edit image, wavespeed generate video. Arquivos locais são passados com @./file e os resultados são baixados com --download.
Funciona no Cursor e em outros agentes de código?
Sim. Qualquer agente que execute comandos no terminal pode usar a CLI, e a skill ensina os comandos a ele. Agentes compatíveis com MCP também podem se conectar ao servidor hospedado.
Também posso gerar vídeos?
Sim. wavespeed generate video cria um clipe a partir de texto, de uma imagem inicial ou de imagens de referência, e wavespeed edit video e extend video alteram ou continuam um vídeo existente.
Quanto custa?
Você paga por geração com seu saldo WaveSpeed, sem assinatura. Adicione --estimate para ver o preço antes de executar qualquer coisa; cada resultado informa quanto custou.
O que seu agente pode fazer via MCP
Ferramentas de atalho para o dia a dia com imagem e vídeo, mais o catálogo completo: buscar modelos, ler as entradas reais de um modelo, consultar o preço e rodar.
generate_imageCrie uma imagem a partir de um prompt, com imagens de referência opcionais
edit_imageEdite, mude o estilo ou combine imagens existentes
generate_videoCrie um vídeo a partir de um prompt, um primeiro quadro ou referências
edit_videoMude o que acontece num vídeo existente
extend_videoContinue um vídeo com novas cenas
list_modelsBusque no catálogo ao vivo por texto ou tipo
get_model_schemaAs entradas reais, campos obrigatórios e padrões de um modelo
run_modelExecute qualquer modelo; entradas @arquivo locais são enviadas automaticamente
get_priceConsulte o custo antes de gastar
get_balanceVeja seu saldo de créditos
upload_fileTransforme um arquivo local em uma URL hospedada
get_predictionRetome uma geração longa pelo id
list_predictionsVeja o histórico das suas gerações
list_billingsVeja cobranças e reembolsos item a item
get_usageAcompanhe gastos e uso por dia e modelo
delete_predictionsExcluir execuções do histórico (pergunta antes)
upload_file existe apenas no servidor local. O servidor remoto não consegue ler seus arquivos: passe URLs públicas, use create_upload em uma ferramenta que consiga enviar requisições HTTP ou, no ChatGPT, anexe o arquivo ao chat.
Código aberto. Pronto hoje.
Licenciado MIT, publicado sob @wavespeed no npm, hospedado no GitHub. Issues e PRs bem-vindos.
Prefere um aplicativo gráfico? Experimente o WaveSpeed DesktopVeja todas as formas de conectar o WaveSpeed