WaveSpeed MCP · CLI

Genera immagini e video in Claude, ChatGPT, Cursor e Codex

Collega WaveSpeed all'agente AI che usi già, poi chiedi e basta. Trova il modello, ti dice il prezzo e genera. Accedi una volta nel browser: nessuna chiave API da copiare.

Collega con un clic

https://api.wavespeed.ai/mcp

WaveSpeed MCP

Cosa puoi creare

Risultati reali ottenuti con WaveSpeed MCP. Scegli dove lavori, poi invia la richiesta con un clic o copiala.

Invia da

Genera un'immagine

Una foto editoriale di moda da una sola descrizione.

Create a fashion editorial photo of a young woman standing between sculptural archways painted coral and sky blue, one hand on the curved wall. She wears a voluminous ivory gown with ruffled sleeves and tiny pearl details, her long dark hair in a single thick braid with a small white flower. Soft studio light, saturated colours, the grain of 35mm film.

Prova in Claude

Genera un video

Una clip cinematografica con audio, movimenti di camera e tutto il resto.

Make an 8-second video of a young man with curly hair in a yellow raincoat running up a stone seaside staircase in the rain, laughing. The handheld camera follows him to the top, where he catches his breath and looks out at a stormy sea as the wind blows his hood back. Sound of rain, waves and his breathing.

Prova in Claude

Mini drama

La tua storia come una scena con un cast coerente e dialoghi parlati.

Turn my story into a short drama scene with a consistent cast: a gruff old lighthouse keeper finds a soaked young sailor at his door on a stormy night. First make a still of both characters, then a 10-second scene with spoken dialogue. He says: "You're lucky the light was still on." She answers: "I thought this place was empty."

Prova in Claude

Recensione prodotto UGC

Una recensione del tuo prodotto in stile creator, da una sola foto.

Make a creator-style product review of my product (ask me for a photo): a friendly creator at her kitchen table holds it up to her phone and says: "Okay, I've used this bottle every day for a month. Ice lasts the whole day, and it hasn't leaked in my bag once." Vertical, handheld, natural light, about 8 seconds.

Prova in Claude

Allega il tuo file quando Claude te lo chiede.

Prima
Dopo

Ricrea un annuncio

Mantieni movimento di camera, ritmo e atmosfera di un annuncio di riferimento, con il tuo prodotto al centro.

Recreate the reference ad I give you (ask me for the video) for my own product (ask me for a photo): keep its camera move, pacing, lighting and mood, but show my product instead. Tell me the price first.

Prova in Claude

Allega il tuo file quando Claude te lo chiede.

Prima
Dopo

Upscale a 4K

Trasforma un'immagine piccola e sfocata in una nitida in 4K.

Upscale my image to 4K (ask me to attach it). Keep the face, colours and composition exactly as they are, just make it sharp. Use a dedicated upscaler and tell me the price first.

Prova in Claude

Allega il tuo file quando Claude te lo chiede.

Prima
Dopo

Montaggio aura

Le tue riprese con un nuovo stile: bagliori, speed ramp e transizioni flash.

Turn my footage (ask me for the video) into an aura edit: keep the person and the camera movement, add a glowing aura outline, speed-ramped slow motion, flash-frame transitions and film grain with light leaks, cut to a pulsing electronic beat.

Prova in Claude

Allega il tuo file quando Claude te lo chiede.

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

Un clic

Funziona in Claude sul web e in Claude Desktop. Niente da installare.

  1. 1

    Fai clic sul pulsante: Claude si apre con WaveSpeed già inserito come connettore personalizzato. Fai clic su Add.

    Aggiungi a Claude
  2. 2

    Accedi a WaveSpeed quando richiesto e approva la connessione

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

Altri modi

Oppure aggiungilo a mano: in Claude apri Customize → Connectors → Add custom connector e incolla questo indirizzo.

https://api.wavespeed.ai/mcp

Genera immagini e video in ChatGPT, Claude, Codex e Claude Code

Collega WaveSpeed una volta, poi basta chiedere. Il tuo agente sceglie lo strumento, crea l’immagine e ti dice quanto è costata.

ChatGPT · WaveSpeed collegato

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 · 16:9
generate_image
  prompt: cozy coffee shop at sunrise, warm light in the windows, room for a headline
  aspect_ratio: 16:9

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
edit_image
  prompt: add the words "Open at 7" in white hand lettering on the front window
  images: [hero.jpg]

Generare immagini e video nel tuo assistente AI

Come genero immagini in ChatGPT con WaveSpeed?

In ChatGPT apri Plugins, scegli Add custom MCP server, incolla https://api.wavespeed.ai/mcp e accedi con il tuo account WaveSpeed. Poi chiedi un’immagine con parole semplici, per esempio «fai un’immagine hero 16:9 di una caffetteria all’alba».

Claude Desktop può generare immagini e video?

Sì, una volta aggiunto WaveSpeed come connettore. In Claude (desktop o web) apri Customize → Connectors → Add custom connector, incolla https://api.wavespeed.ai/mcp e accedi. Da lì Claude può creare e modificare immagini e video per te.

Come genero immagini e video in Codex?

In Codex apri /plugins, installa WaveSpeed e approva la connessione nel browser. Codex potrà così generare immagini e video mentre lavora al tuo progetto e salvarli al suo interno.

Come genero immagini in Claude Code?

Aggiungi il marketplace di WaveSpeed, installa il plugin, poi esegui /mcp in Claude Code e approva la connessione. Chiedi un’immagine o un video e Claude Code chiamerà WaveSpeed per te.

Posso modificare un’immagine o farci un video nella stessa chat?

Sì. Chiedi una modifica («fai il podio verde menta») e l’agente modifica l’ultima immagine; chiedi un video e può animare un’immagine o creare un’intera clip.

Quanto costa?

Paghi per generazione dal tuo saldo WaveSpeed, senza abbonamento. L’agente può mostrarti il prezzo prima di avviare, e 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.

Preferisci il terminale? Usa la CLI

Lo stesso catalogo dalla tua shell, dai tuoi script e dagli agenti che eseguono comandi: un unico comando open source per ogni modello, con output JSON da passare in pipe.

CLI

@wavespeed/cli

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

$npm install -g @wavespeed/cli

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
}

Open source. Pronta oggi.

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

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