TrasformaClaudeClaudein un motore per video musicali

Collega freebeat a Claude, Cursor, Windsurf e Claude Code, e genera video musicali ed effetti IA direttamente dalle tue conversazioni.

API Keys
1

Apri la configurazione Claude Desktop

Avvia Claude Desktop e apri la configurazione locale del server MCP.
Claude Desktop
2

Aggiungi il server MCP freebeat

Chiamalo freebeat e aggiungi il comando locale del server MCP:
3

Imposta FREEBEAT_API_KEY

Crea una API Key in freebeat, aggiungila all’ambiente MCP e chiedi a Claude di avviare un task video musicale.
API Keys → Profilo

IL SET DI COMANDI

auth

Salva e controlla localmente la tua API Key freebeat, oppure passa --api-key per singolo comando quando serve.

set-api-keyshow--api-key

assets

Carica audio da file locale o URL sorgente e aggiungi una o due immagini di riferimento.

upload-audioupload-imagemusic_id

effects

Elenca gli effetti video disponibili e controlla effect_id, anteprime, musica predefinita e formati.

listeffect_idpreview

mv

Invia o esegui generazione video musicale IA da brano caricato, prompt, riferimenti e formato.

submitrun--json

effect

Genera clip da template effetto con effect_id, music_id, URL immagine e prompt.

submitruneffect_id

task

Controlla lo stato, attendi il completamento e recupera video_url e cover_url dai task completati.

statuswaitresult

UNO STUDIO COMPLETO DI VIDEO MUSICALI DENTRO CLAUDE

Generazione video musicali, effetti IA, upload media e gestione task in una sola connessione

Terminale

> Genera un video musicale città neon per questa traccia

--aspect 9:16

--reference cover.png

 

● freebeat

Upload audio...

Creazione task video musicale...

→ ./output/neon_mv.mp4

MEDIA GENERATIVI

GENERAZIONE DI VIDEO MUSICALI

Parti da un brano, un prompt o un link musicale e lascia che il tuo agente chiami freebeat per generare un MV completo con formati, riferimenti, effetti e risultati di render asincroni.

MOTORE EFFETTI

UN PROMPT TRASFORMA LA MUSICA IN SHORTS

Chiedi al tuo agente di trovare l’effetto video giusto, inserire musica, immagini di riferimento e prompt, quindi generare clip pronte per campagne e social media.

Agente

> Trova effetti per un teaser di lancio prodotto

 

● freebeat

Trovati 8 effetti compatibili.

Generazione di 3 varianti video...

✓ teaser verticale

✓ clip social quadrata

Modalità

upload_audio Importa audio o URL sorgente

upload_image Aggiungi una o due referenze

list_effects Vedi opzioni effect_id

generate_music_video Avvia task MV

generate_effect Avvia task effetto

get_task_status Controlla stato task

get_task_result Recupera video_url + cover_url

MODALITÀ

SCEGLI UN EFFETTO, SALTA IL SETUP

Parti da effect_id, musica predefinita, riferimenti consigliati e istruzioni del template. Il tuo agente può confrontare i template prima di generare.

AUTOMAZIONE

DALLA CARTELLA DI BRANI ALLA PIPELINE VIDEO

CLI e MCP condividono lo stesso modello di task. Usa Claude per pianificare la creatività, poi carica, genera, attendi e salva JSON strutturato da script terminale.

Terminale

> Crea 5 video musicali da ./songs

 

● freebeat

Lettura cartella...

Invio job...

✓ 5 task ids salvati

✓ results.json pronto

UNO STUDIO COMPLETO DI VIDEO MUSICALI DENTRO IL TUO AGENTE

Upload audio, riferimenti immagine, template effetti e risultati di render in una sola connessione MCP

Terminale

$ freebeat assets upload-audio --file song.mp3

$ freebeat assets upload-image cover.png

$ freebeat mv run --audio song.mp3 --image cover.png --prompt "neon city performance" --json

 

● freebeat

Upload audio e immagine di riferimento...

Creazione task video musicale...

 

✓ music_id 123

✓ task_id task-8H4n2

✓ status pending

 

✓ JSON pronto per il polling

Ogni asset musicale

Trasforma qualsiasi URL di brano, file audio locale, riferimento prodotto o brief campagna in un workflow video completo.

Terminale

$ freebeat effects list --json

$ freebeat effect run --effect-id 12 --prompt "kinetic neon chorus" --json

 

→ caricamento template effetti...

 

● freebeat

 

effect_id 12 selezionato

image_url predefinita selezionata

music_id predefinito

prompt kinetic neon chorus

 

payload task pronto

Il tuo stile in ogni prompt

Immagini di riferimento e prompt riutilizzabili mantengono coerente la direzione visiva tra MV e generazione effetti.

Terminale

$ freebeat task wait task-8H4n2

$ freebeat task result task-8H4n2 --json

 

● freebeat

stato pending → completed

 

✓ video_url https://cdn.freebeat.ai/...

✓ cover_url https://cdn.freebeat.ai/...

✓ metadata.json scritto

Risultati pronti per automazione

Task IDs, controlli stato, URL video, URL copertina ed errori strutturati vengono restituiti per script e agenti.

Terminale

$ freebeat assets upload-audio --file ./songs/track-01.mp3

$ freebeat mv submit --music-id 123 --prompt "vertical release cut" --json

 

● freebeat

Lettura metadati sorgente...

Invio task video musicali asincroni...

 

✓ task_id task-101

✓ task_id task-102

✓ results.json pronto

Varianti di video musicali su scala

Genera cut di campagna, loop short-form e versioni con effetti mantenendo ogni risultato organizzato per la pubblicazione.

DAL CONCEPT AL CONTENUTO IN UNA CONVERSAZIONE

Dì a Claude cosa stai creando. Sceglierà gli strumenti MCP freebeat corretti e consegnerà risultati video musicali pronti per la produzione

DALL’IDEA AL VIDEO MUSICALE IN UNA CONVERSAZIONE

Inizia con una generazione semplice o approfondisci con discovery effetti, riferimenti, batch job e polling task. Claude gestisce il workflow

Creazione asset

Invia un task video musicale in pochi secondi

Descrivi mood, formato e sorgente musicale. Claude sceglie lo strumento MCP freebeat e restituisce il task_id.

Genera un MV cyberpunk 9:16 per questa traccia
Produzione completa

Crea un pacchetto release da una conversazione

Crea un hero MV, un taglio quadrato e varianti brevi mantenendo la stessa direzione visiva.

Crea tre cut social e salva tutti i link video
Automazione

Confronta effetti e pubblica il risultato migliore

Elenca effetti freebeat, genera varianti, attendi il completamento e scegli l’output più forte.

Prova 4 effetti e mostrami i video completati

ALTRE DOMANDE?

Abbiamo risposto alle domande più frequenti

Come si collega freebeat agli agenti IA?

Aggiungi il server MCP freebeat a qualsiasi client compatibile MCP. Il comando è npx -y freebeat-mcp, autorizzato con la variabile ambiente FREEBEAT_API_KEY.

Dove creo una API Key?

Accedi a freebeat e apri /music-video-generator/profile. Crea una chiave nella sezione API Keys. Il link API Keys di questa pagina porta lì.

Quali agenti sono supportati?

Claude Desktop, Cursor, Windsurf, Claude Code e altri client compatibili MCP possono usare la stessa configurazione server freebeat.

Qual è la differenza tra MCP e CLI?

MCP è per conversazioni con agenti. CLI è per terminali e script. Entrambi espongono upload, effetti, generazione, polling e recupero risultati.

Perché i job di generazione richiedono polling?

Il rendering di un video musicale può richiedere tempo. freebeat restituisce prima un task_id, poi agente o CLI controllano lo stato e recuperano video_url al completamento.

Cosa posso creare?

Puoi creare video musicali, clip con template effetto, video social verticali, MV widescreen e versioni guidate dallo stile con immagini di riferimento.

Devo inserire la API Key nei prompt?

No. Tieni la chiave nella configurazione ambiente MCP o nelle credenziali CLI. Il prompt deve descrivere solo il task creativo.

Posso usare il risultato in automazione?

Sì. I task completati restituiscono link e campi stato strutturati che funzionano bene con file JSON, fogli di calcolo, calendari contenuti e script.

IL TUO STACK IA SALE DI LIVELLO

Collega Claude, Cursor, Windsurf o Claude Code a freebeat in pochi secondi. Video musicali, effetti IA e risultati render on demand.

Inizia

ESPLORA ALTRE FUNZIONI IA