WaveSpeed CLI · MCP
Cada modelo de WaveSpeed — desde tu terminal y agente
Una CLI de código abierto para ejecutar cualquier modelo de IA de WaveSpeed. Imagen, vídeo, audio, 3D. Diseñada para terminales y agentes de código como Codex, Claude Code, Claude Cowork y Cursor.
$npm install -g @wavespeed/cliTres comandos y a desplegar
Instalar
Requiere Node 18+. Una instalación global te deja el binario wavespeed disponible en todas partes.
$npm install -g @wavespeed/cliIniciar sesión
Abre la página de access-key en tu navegador. Detectamos automáticamente una clave copiada y la validamos en vivo.
$wavespeed loginEjecutar cualquier modelo
Misma forma para todos los modelos. Pasa el ID del modelo y los inputs — obtén una URL de CDN, o canaliza --json a tus scripts.
$wavespeed run wavespeed-ai/z-image/turbo -p "a cat"Hecho para humanos y agentes
Ayuda dinámica por modelo
Ejecuta wavespeed run <model> -h y la CLI obtiene en vivo el esquema de entrada de ese modelo e imprime exactamente las flags que acepta — sin adivinanzas.
Aliases que viajan con tu repo
Define atajos con nombre en wavespeed.json que agrupan un modelo + inputs por defecto. Los equipos descargan el archivo, escriben wavespeed run hero y obtienen resultados alineados con la marca.
Diseñado de forma nativa para agentes
Cada comando soporta --json en stdout y progreso en stderr. Coloca un SKILL.md para que Codex, Claude Code, Claude Cowork y Cursor sepan cómo llamarlo.
Sin magia, sin daemon
La CLI nunca modifica tu prompt y nunca abre un proceso en segundo plano. Llama a api.wavespeed.ai directamente. Código abierto, licencia MIT.
Cómo se ve una sesión real
Del navegado del catálogo a la salida JSON — tres 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
}Conéctalo a tu agente de codificación en un paso
Sin configuración extra. Los agentes de código como Codex, Claude Code y Claude Cowork ya saben ejecutar comandos de shell: el SKILL.md les explica cómo usar la CLI.
$wavespeed skill installFunciona con Codex, Claude Code, Claude Cowork, Cursor y cualquier agente que cargue automáticamente .claude/skills/*.
¿Prefieres MCP? Conecta cualquier cliente MCP
El servidor MCP de WaveSpeed ofrece a Claude Desktop, Claude Code, Cursor, Cline y cualquier otro cliente MCP el mismo catálogo en vivo: busca modelos, consulta las entradas reales de un modelo, cotiza el precio y ejecútalo.
¿Iniciaste sesión con wavespeed login? El servidor MCP usa la misma sesión. Si no, define WAVESPEED_API_KEY.
Claude Code
$claude mcp add wavespeed -- npx -y @wavespeed/mcpClaude Desktop y otros clientes
Añade esto a la sección mcpServers de la configuración de tu cliente.
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Siete herramientas
list_modelsBusca en el catálogo en vivo por texto o tipo
get_model_schemaLas entradas reales, campos obligatorios y valores por defecto de un modelo
run_modelEjecuta cualquier modelo; las entradas @archivo locales se suben solas
get_priceCotiza el coste antes de gastar
get_balanceConsulta tu saldo de créditos
upload_fileConvierte un archivo local en una URL alojada
get_predictionRetoma una generación larga por su id
Código abierto. Listo hoy.
Licencia MIT, publicado como @wavespeed en npm, alojado en GitHub. Issues y PRs son bienvenidos.