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/cli

MCP

@wavespeed/mcp

Servidor MCP hospedado: adicione pelo endereço em qualquer cliente MCP e entre.

https://api.wavespeed.ai/mcp

Configure 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

Plugin

Adiciona o servidor MCP hospedado e a skill do WaveSpeed numa única instalação.

  1. 1

    Adicione o marketplace do WaveSpeed

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    Instale o plugin

    $claude plugin install wavespeed@wavespeed
  3. 3

    No Claude Code, rode /mcp, escolha wavespeed e aprove a conexão no navegador

    /mcp
Depois peça: “Crie uma imagem hero 16:9 de um skyline cyberpunk e me diga o preço antes.”

Outras formas

Só o servidor MCP, sem a skill:

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

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

  1. 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. 2

    Entrar

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

    $wavespeed login
  3. 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 install
  • Nã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 | bash
  • Mantenha-se atualizado

    Atualize para a versão mais recente com um único comando.

    $wavespeed upgrade
  • Use 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.

~/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://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.

Claude Code · WaveSpeed CLI

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.

Uma cafeteria aconchegante ao nascer do sol vista da rua

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 --download

Legal. Escreva "Open at 7" na vitrine.

A mesma cafeteria com "Open at 7" pintado na vitrine

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 --download

Gerando 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_image

Crie uma imagem a partir de um prompt, com imagens de referência opcionais

edit_image

Edite, mude o estilo ou combine imagens existentes

generate_video

Crie um vídeo a partir de um prompt, um primeiro quadro ou referências

edit_video

Mude o que acontece num vídeo existente

extend_video

Continue um vídeo com novas cenas

list_models

Busque no catálogo ao vivo por texto ou tipo

get_model_schema

As entradas reais, campos obrigatórios e padrões de um modelo

run_model

Execute qualquer modelo; entradas @arquivo locais são enviadas automaticamente

get_price

Consulte o custo antes de gastar

get_balance

Veja seu saldo de créditos

upload_file

Transforme um arquivo local em uma URL hospedada

get_prediction

Retome uma geração longa pelo id

list_predictions

Veja o histórico das suas gerações

list_billings

Veja cobranças e reembolsos item a item

get_usage

Acompanhe gastos e uso por dia e modelo

delete_predictions

Excluir 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