Iniciar sesión

WaveSpeed CLI · MCP

Genera imágenes y videos desde Claude Code, Codex y tu terminal

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.

CLI

@wavespeed/cli

Instala una vez y ejecuta cualquier modelo desde la terminal o tus scripts.

$npm install -g @wavespeed/cli
Instalar desde npmVer en GitHub

MCP

@wavespeed/mcp

Servidor MCP alojado: añádelo por su dirección en cualquier cliente MCP e inicia sesión.

https://api.wavespeed.ai/mcp
Elige tu agenteVer en GitHub

Configura WaveSpeed en tu agente

Elige tu herramienta y te mostramos la forma más rápida. Todas dan acceso al catálogo completo, con el precio antes de gastar.

Claude Code

Plugin

Añade el servidor MCP alojado y la skill de WaveSpeed en una sola instalación.

  1. 1

    Añade el marketplace de WaveSpeed

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

    Instala el plugin

    $claude plugin install wavespeed@wavespeed
  3. 3

    En Claude Code, ejecuta /mcp, elige wavespeed y aprueba la conexión en el navegador

    /mcp
Después pide: “Haz una imagen hero 16:9 de un skyline cyberpunk y dime antes el precio.”

Otras opciones

Solo el servidor MCP, sin la skill:

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

Tres comandos y a desplegar

  1. 1

    Instalar

    Requiere Node 18+. Una instalación global te deja el binario wavespeed disponible en todas partes.

    $npm install -g @wavespeed/cli
  2. 2

    Iniciar sesión

    Abre la página de access-key en tu navegador. Detectamos automáticamente una clave copiada y la validamos en vivo.

    $wavespeed login
  3. 3

    Ejecutar 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"

  • Enseña la CLI a tu agente

    Instala una skill para que Codex, Claude Code, Cursor y otros agentes sepan cómo usarla.

    $wavespeed skill install

  • ¿No tienes Node.js?

    En macOS y Linux puedes instalar un ejecutable independiente. En Windows, descárgalo desde GitHub Releases.

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash

  • Mantente al día

    Actualiza a la última versión con un solo comando.

    $wavespeed upgrade

  • Usa los modelos de WaveSpeed en tu agente de programación

    Configura Claude Code, Codex, OpenCode y más para usar la API LLM de WaveSpeed. Puedes deshacerlo cuando quieras.

    $wavespeed setup

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.

~/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
}

Genera imágenes y videos desde Claude Code y Codex

Instala la CLI y su skill una vez y luego solo pide. Tu agente de programación ejecuta los comandos y guarda los archivos en tu proyecto.

Claude Code · WaveSpeed CLI

Hazme una imagen hero 16:9 para la landing page de mi cafetería: acogedora, al amanecer y con espacio para un titular.

Una cafetería acogedora al amanecer vista desde la calle

Aquí tienes tu imagen hero: luz cálida del amanecer sobre la fachada, con encuadre amplio para un banner. · Costo $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

Genial. Escribe "Open at 7" en el ventanal.

La misma cafetería con "Open at 7" rotulado en la ventana

Listo: "Open at 7" está rotulado a mano en la ventana y todo lo demás sigue igual. · Costo $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

Genera imágenes y videos desde tu agente de programación

¿Cómo genero imágenes desde Claude Code?

Instala la CLI con npm install -g @wavespeed/cli, inicia sesión con wavespeed login y agrega la skill con wavespeed skill install. Luego pídele una imagen a Claude Code; ejecutará wavespeed generate image y guardará el archivo en tu proyecto.

¿Cómo genero imágenes y videos desde Codex?

Instala la CLI, inicia sesión y ejecuta wavespeed skill install para que Codex conozca los comandos. Pídele a Codex una imagen o un video y los ejecutará por ti, o instala el plugin de WaveSpeed desde /plugins.

¿Qué ejecuta realmente el agente?

Comandos normales que puedes leer y repetir: wavespeed generate image, wavespeed edit image, wavespeed generate video. Los archivos locales se pasan con @./file y los resultados se descargan con --download.

¿Funciona en Cursor y otros agentes de programación?

Sí. Cualquier agente que pueda ejecutar comandos en la terminal puede usar la CLI, y la skill le enseña los comandos. Los agentes compatibles con MCP también pueden conectarse al servidor alojado.

¿También puedo generar videos?

Sí. wavespeed generate video crea un clip a partir de texto, una imagen inicial o imágenes de referencia, y wavespeed edit video y extend video modifican o continúan uno existente.

¿Cuánto cuesta?

Pagas por generación con tu saldo de WaveSpeed, sin suscripción. Añade --estimate para ver el precio antes de ejecutar nada; cada resultado indica cuánto costó.

Lo que tu agente puede hacer por MCP

Herramientas rápidas para el trabajo diario con imagen y vídeo, más el catálogo completo: busca modelos, consulta sus entradas reales, pide el precio y ejecútalo.

generate_image

Crea una imagen a partir de un prompt, con imágenes de referencia opcionales

edit_image

Edita, cambia el estilo o combina imágenes existentes

generate_video

Crea un vídeo a partir de un prompt, un primer fotograma o referencias

edit_video

Cambia lo que ocurre en un vídeo existente

extend_video

Continúa un vídeo con nuevas imágenes

list_models

Busca en el catálogo en vivo por texto o tipo

get_model_schema

Las entradas reales, campos obligatorios y valores por defecto de un modelo

run_model

Ejecuta cualquier modelo; las entradas @archivo locales se suben solas

get_price

Cotiza el coste antes de gastar

get_balance

Consulta tu saldo de créditos

upload_file

Convierte un archivo local en una URL alojada

get_prediction

Retoma una generación larga por su id

list_predictions

Consulta el historial de tus generaciones

list_billings

Consulta cargos y reembolsos uno por uno

get_usage

Revisa el gasto y el uso por día y modelo

delete_predictions

Eliminar ejecuciones del historial (pregunta antes)

upload_file solo está en el servidor local. El servidor remoto no puede leer tus archivos: pasa URL públicas, usa create_upload desde una herramienta que pueda enviar solicitudes HTTP o, en ChatGPT, adjunta el archivo al chat.

GitHubnpmDocumentación

Código abierto. Listo hoy.

Licencia MIT, publicado como @wavespeed en npm, alojado en GitHub. Issues y PRs son bienvenidos.

CLIInstalar desde npmDar estrella en GitHub
MCPElige tu agenteDar estrella en GitHub

¿Prefieres una aplicación gráfica? Prueba WaveSpeed DesktopVer todas las formas de conectar WaveSpeed

Seedream 5.5 ya está DISPONIBLE | Pruébalo en el generador de imágenes →