Accedi

WaveSpeed CLI · MCP

Genera immagini e video da Claude Code, Codex e dal tuo terminale

Una CLI open-source per eseguire qualsiasi modello AI WaveSpeed. Immagine, video, audio, 3D. Pensata per terminali e coding agent come Codex, Claude Code, Claude Cowork e Cursor.

CLI

@wavespeed/cli

Installa una volta ed esegui qualsiasi modello dalla shell o dagli script.

$npm install -g @wavespeed/cli
Installa da npmVedi su GitHub

MCP

@wavespeed/mcp

Server MCP ospitato: aggiungilo tramite indirizzo in qualsiasi client MCP e accedi.

https://api.wavespeed.ai/mcp
Scegli il tuo agenteVedi su GitHub

Configura WaveSpeed nel tuo agente

Scegli il tuo strumento per la configurazione più rapida. Ogni opzione dà accesso all'intero catalogo, con il prezzo prima di spendere.

Claude Code

Plugin

Aggiunge il server MCP ospitato e la skill WaveSpeed in un'unica installazione.

  1. 1

    Aggiungi il marketplace WaveSpeed

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

    Installa il plugin

    $claude plugin install wavespeed@wavespeed
  3. 3

    In Claude Code esegui /mcp, scegli wavespeed e approva la connessione nel browser

    /mcp
Poi chiedi: “Crea un'immagine hero 16:9 di uno skyline cyberpunk e dimmi prima il prezzo.”

Altri modi

Solo il server MCP, senza la skill:

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

Tre comandi e sei in produzione

  1. 1

    Installa

    Richiede Node 18+. Una sola installazione globale mette il binario wavespeed a disposizione ovunque.

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

    Accedi

    Apre la pagina della chiave di accesso nel tuo browser. Rileviamo automaticamente una chiave copiata e la validiamo in tempo reale.

    $wavespeed login
  3. 3

    Esegui qualsiasi modello

    Stessa forma per tutti i modelli. Passa l'ID del modello e gli input — ricevi una URL CDN, o invia --json ai tuoi script in pipe.

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"

  • Insegna la CLI al tuo agente

    Installa una skill così Codex, Claude Code, Cursor e altri agenti sanno come usarla.

    $wavespeed skill install

  • Non hai Node.js?

    Su macOS e Linux puoi installare un eseguibile autonomo. Su Windows, scaricalo da GitHub Releases.

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

  • Resta aggiornato

    Passa all'ultima versione con un solo comando.

    $wavespeed upgrade

  • Usa i modelli WaveSpeed nel tuo agente di programmazione

    Configura Claude Code, Codex, OpenCode e altri per usare l'API LLM di WaveSpeed. Annullabile in qualsiasi momento.

    $wavespeed setup

Costruita per persone e agenti

Aiuto dinamico per modello

Esegui wavespeed run <model> -h e la CLI recupera in tempo reale lo schema di input di quel modello e stampa esattamente i flag che accetta — niente congetture.

Alias che viaggiano con il tuo repo

Definisci scorciatoie con nome in wavespeed.json che raggruppano un modello + input predefiniti. I team scaricano il file, digitano wavespeed run hero e ottengono output coerente con il brand.

Nativa per agenti per design

Ogni comando supporta --json su stdout e il progresso su stderr. Aggiungi un file SKILL.md così Codex, Claude Code, Claude Cowork e Cursor sanno come chiamarla.

Niente magia, niente daemon

La CLI non modifica mai il tuo prompt e non apre alcun processo in background. Chiama direttamente api.wavespeed.ai. Open source, licenza MIT.

Com'è fatta una sessione reale

Dalla navigazione del catalogo all'output JSON — tre comandi.

~/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 immagini e video da Claude Code e Codex

Installa la CLI e la sua skill una volta, poi basta chiedere. Il tuo agente di coding esegue i comandi e salva i file nel tuo progetto.

Claude Code · WaveSpeed CLI

Fammi un’immagine hero 16:9 per la landing page della mia caffetteria: accogliente, all’alba, con spazio per un titolo.

Una caffetteria accogliente all’alba vista dalla strada

Ecco la tua immagine hero: luce calda dell’alba sulla vetrina, inquadratura ampia per 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

Bella. Scrivi "Open at 7" sulla vetrina.

La stessa caffetteria con "Open at 7" scritto sulla vetrina

Fatto: "Open at 7" è scritto a mano sulla vetrina, tutto il resto è invariato. · 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

Generare immagini e video dal tuo agente di coding

Come genero immagini da Claude Code?

Installa la CLI con npm install -g @wavespeed/cli, accedi con wavespeed login e aggiungi la skill con wavespeed skill install. Poi chiedi un’immagine a Claude Code: eseguirà wavespeed generate image e salverà il file nel tuo progetto.

Come genero immagini e video da Codex?

Installa la CLI, accedi ed esegui wavespeed skill install perché Codex conosca i comandi. Chiedi a Codex un’immagine o un video e li eseguirà per te, oppure installa il plugin WaveSpeed da /plugins.

Cosa esegue davvero l’agente?

Comandi normali che puoi leggere e ripetere: wavespeed generate image, wavespeed edit image, wavespeed generate video. I file locali si passano con @./file e i risultati si scaricano con --download.

Funziona in Cursor e in altri agenti di coding?

Sì. Qualsiasi agente in grado di eseguire comandi da terminale può usare la CLI, e la skill gli insegna i comandi. Gli agenti compatibili con MCP possono anche collegarsi al server ospitato.

Posso generare anche video?

Sì. wavespeed generate video crea una clip da testo, da un’immagine iniziale o da immagini di riferimento, e wavespeed edit video ed extend video modificano o proseguono un video esistente.

Quanto costa?

Paghi per generazione dal tuo saldo WaveSpeed, senza abbonamento. Aggiungi --estimate per vedere il prezzo prima di eseguire qualsiasi cosa; ogni risultato indica quanto è costato.

Cosa può fare il tuo agente via MCP

Strumenti rapidi per il lavoro quotidiano su immagini e video, più tutto il catalogo: cerca modelli, leggi i loro input reali, chiedi il prezzo e avvia.

generate_image

Crea un'immagine da un prompt, con immagini di riferimento opzionali

edit_image

Modifica, cambia stile o combina immagini esistenti

generate_video

Crea un video da un prompt, un primo fotogramma o riferimenti

edit_video

Cambia ciò che accade in un video esistente

extend_video

Prolunga un video con nuove riprese

list_models

Cerca nel catalogo dal vivo per testo o tipo

get_model_schema

Gli input reali, i campi obbligatori e i valori predefiniti di un modello

run_model

Esegui qualsiasi modello; gli input @file locali vengono caricati in automatico

get_price

Conosci il costo prima di spendere

get_balance

Controlla il saldo dei crediti

upload_file

Trasforma un file locale in un URL ospitato

get_prediction

Riprendi una generazione lunga tramite il suo id

list_predictions

Consulta la cronologia delle tue generazioni

list_billings

Vedi addebiti e rimborsi voce per voce

get_usage

Controlla spesa e utilizzo per giorno e modello

delete_predictions

Eliminare esecuzioni dalla cronologia (chiede prima)

upload_file è disponibile solo nel server locale. Il server remoto non può leggere i tuoi file: passa URL pubblici, usa create_upload da uno strumento in grado di inviare richieste HTTP oppure, in ChatGPT, allega il file alla chat.

GitHubnpmDocumentazione

Open source. Pronta oggi.

Licenza MIT, distribuita sotto @wavespeed su npm, ospitata su GitHub. Issues e PR benvenuti.

CLIInstalla da npmStellala su GitHub
MCPScegli il tuo agenteStellala su GitHub

Preferisci un’app grafica? Prova WaveSpeed DesktopScopri tutti i modi per collegare WaveSpeed

Seedream 5.5 è ONLINE | Provalo nel generatore di immagini →