VerwandleClaudeClaudein eine Musikvideo-Engine

Verbinde freebeat mit Claude, Cursor, Windsurf und Claude Code und generiere Musikvideos und KI-Effekte direkt aus deinen Gesprächen.

API Keys
1

Claude Desktop-Konfiguration öffnen

Starte Claude Desktop und öffne die lokale MCP-Serverkonfiguration.
Claude Desktop
2

freebeat MCP-Server hinzufügen

Nenne ihn freebeat und füge den lokalen MCP-Server-Befehl ein:
3

FREEBEAT_API_KEY setzen

Erstelle in freebeat einen API Key, füge ihn der MCP-Umgebung hinzu und bitte Claude, einen Musikvideo-Task zu starten.
API Keys → Profil

DER BEFEHLSSATZ

auth

Speichere und prüfe deinen freebeat API Key lokal oder übergib bei Bedarf --api-key pro Befehl.

set-api-keyshow--api-key

assets

Lade Audio aus einer lokalen Datei oder Quell-URL hoch und füge ein oder zwei Referenzbilder hinzu.

upload-audioupload-imagemusic_id

effects

Liste verfügbare Videoeffekte und prüfe effect_id, Vorschaumedien, Standardmusik und Seitenverhältnisse.

listeffect_idpreview

mv

Reiche KI-Musikvideo-Generierung mit hochgeladenem Song, Prompt, Referenzen und Seitenverhältnis ein oder starte sie direkt.

submitrun--json

effect

Generiere Effekt-Template-Clips mit effect_id, music_id, Bild-URL und Prompt.

submitruneffect_id

task

Prüfe den Status, warte auf Abschluss und hole video_url und cover_url aus fertigen Tasks.

statuswaitresult

EIN KOMPLETTES MUSIKVIDEO-STUDIO IN CLAUDE

Musikvideo-Generierung, KI-Effekte, Medien-Upload und Task-Verwaltung in einer Verbindung

Terminal

> Generiere ein Neon-City-Musikvideo für diesen Track

--aspect 9:16

--reference cover.png

 

● freebeat

Audio wird hochgeladen...

Musikvideo-Task wird erstellt...

→ ./output/neon_mv.mp4

GENERATIVE MEDIEN

MUSIKVIDEO-GENERIERUNG

Starte mit einem Song, Prompt oder Musiklink und lass deinen Agenten freebeat aufrufen, um ein komplettes MV mit Seitenverhältnissen, Referenzen, Effekten und asynchronen Render-Ergebnissen zu erzeugen.

EFFEKT-ENGINE

EIN PROMPT MACHT AUS MUSIK SHORTS

Bitte deinen Agenten, den passenden Videoeffekt zu finden, Musik, Referenzbilder und Prompts auszufüllen und veröffentlichungsreife Clips für Kampagnen und Social Media zu erzeugen.

Agent

> Finde Effekte für einen Product-Launch-Teaser

 

● freebeat

8 passende Effekte gefunden.

3 Videovarianten werden generiert...

✓ vertikaler Teaser

✓ quadratischer Social Clip

Modi

upload_audio Audio oder Quell-URL importieren

upload_image Ein oder zwei Referenzen hinzufügen

list_effects effect_id-Optionen prüfen

generate_music_video MV-Task starten

generate_effect Effekt-Task starten

get_task_status Task-Status pollen

get_task_result video_url + cover_url holen

MODI

EFFEKT WÄHLEN, SETUP ÜBERSPRINGEN

Starte mit effect_id, Standardmusik, empfohlenen Referenzen und Template-Anweisungen. Dein Agent kann Templates vergleichen, bevor er generiert.

AUTOMATION

VOM SONG-ORDNER ZUR VIDEO-PIPELINE

CLI und MCP teilen dasselbe Task-Modell. Nutze Claude für kreative Planung und lade dann per Terminalskript hoch, generiere, warte und speichere strukturiertes JSON.

Terminal

> Erstelle 5 Musikvideos aus ./songs

 

● freebeat

Ordner wird gelesen...

Jobs werden eingereicht...

✓ 5 Task-IDs gespeichert

✓ results.json bereit

EIN KOMPLETTES MUSIKVIDEO-STUDIO IN DEINEM AGENTEN

Audio-Upload, Bildreferenzen, Effekt-Templates und Render-Ergebnisse in einer einzigen MCP-Verbindung

Terminal

$ 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

Audio und Referenzbild werden hochgeladen...

Musikvideo-Task wird erstellt...

 

✓ music_id 123

✓ task_id task-8H4n2

✓ status pending

 

✓ JSON bereit zum Pollen

Jedes Musik-Asset

Verwandle Song-URLs, lokale Audiodateien, Produktreferenzen oder Kampagnenbriefings in einen fertigen Videoworkflow.

Terminal

$ freebeat effects list --json

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

 

→ Effekt-Templates werden geladen...

 

● freebeat

 

effect_id 12 ausgewählt

Standard image_url ausgewählt

music_id Standardmusik

prompt kinetic neon chorus

 

Task-Payload bereit

Dein Stil in jedem Prompt

Referenzbilder und wiederverwendbare Prompts halten die visuelle Richtung über MV- und Effektgenerierungen hinweg konsistent.

Terminal

$ freebeat task wait task-8H4n2

$ freebeat task result task-8H4n2 --json

 

● freebeat

status pending → completed

 

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

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

✓ metadata.json geschrieben

Ergebnisse für Automation

Task-IDs, Statusprüfungen, Video-URLs, Cover-URLs und strukturierte Fehler werden für Skripte und Agenten zurückgegeben.

Terminal

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

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

 

● freebeat

Quellmetadaten werden gelesen...

Asynchrone Musikvideo-Jobs werden eingereicht...

 

✓ task_id task-101

✓ task_id task-102

✓ results.json bereit

Musikvideo-Varianten im großen Maßstab

Generiere Kampagnenschnitte, Short-Form-Loops und Effektversionen und halte jedes Ergebnis für die Veröffentlichung organisiert.

VOM KONZEPT ZUM CONTENT IN EINEM GESPRÄCH

Sag Claude, was du erstellen möchtest. Claude wählt die passenden freebeat MCP-Tools und liefert produktionsreife Musikvideo-Ergebnisse

VON DER IDEE ZUM MUSIKVIDEO IN EINEM GESPRÄCH

Starte klein mit einer Generierung oder gehe tiefer mit Effektsuche, Referenzen, Batch-Jobs und Task-Polling. Claude übernimmt den Workflow

Asset-Erstellung

Einen Musikvideo-Task in Sekunden einreichen

Beschreibe Stimmung, Seitenverhältnis und Musikquelle. Claude wählt das freebeat MCP-Tool und gibt die task_id zurück.

Generiere ein Cyberpunk-MV in 9:16 für diesen Track
Komplette Produktion

Ein Release-Paket aus einem Gespräch bauen

Erstelle ein Hero-MV, einen quadratischen Schnitt und kurze Varianten mit derselben visuellen Richtung.

Erstelle drei Social Cuts und speichere alle Videolinks
Automation

Effekte vergleichen und das beste Ergebnis ausliefern

Liste freebeat-Effekte auf, generiere Varianten, warte auf den Abschluss und wähle das stärkste Ergebnis.

Teste 4 Effekte und zeige mir die fertigen Videos

NOCH FRAGEN?

Wir haben die häufigsten Fragen beantwortet

Wie verbindet sich freebeat mit KI-Agenten?

Füge den freebeat MCP-Server zu einem MCP-kompatiblen Client hinzu. Der Befehl lautet npx -y freebeat-mcp und wird über die Umgebungsvariable FREEBEAT_API_KEY autorisiert.

Wo erstelle ich einen API Key?

Melde dich bei freebeat an und öffne /music-video-generator/profile. Erstelle im Bereich API Keys einen Key. Der API Keys-Link auf dieser Seite führt dorthin.

Welche Agenten werden unterstützt?

Claude Desktop, Cursor, Windsurf, Claude Code und andere MCP-kompatible Clients können dieselbe freebeat-Serverkonfiguration nutzen.

Was ist der Unterschied zwischen MCP und CLI?

MCP ist für Agenten-Gespräche gedacht. CLI ist für Terminals und Skripte. Beide bieten Uploads, Effekte, Generierung, Polling und Ergebnisabruf.

Warum benötigen Generierungsjobs Polling?

Musikvideo-Rendering kann Zeit brauchen. freebeat gibt zuerst eine task_id zurück, danach fragt der Agent oder die CLI den Status ab und holt video_url, sobald der Task fertig ist.

Was kann ich erstellen?

Du kannst Musikvideos, Effekt-Template-Clips, vertikale Social Videos, Widescreen-MVs und stilgeführte Varianten mit Referenzbildern erstellen.

Muss ich meinen API Key in Prompts schreiben?

Nein. Behalte den Key in deiner MCP-Umgebungskonfiguration oder in den CLI-Zugangsdaten. Dein Prompt sollte nur die kreative Aufgabe beschreiben.

Kann ich das Ergebnis in Automation nutzen?

Ja. Abgeschlossene Tasks geben strukturierte Links und Statusfelder zurück, die gut mit JSON-Dateien, Tabellen, Content-Kalendern und Skripten funktionieren.

DEIN KI-STACK IST JETZT STÄRKER

Verbinde Claude, Cursor, Windsurf oder Claude Code in Sekunden mit freebeat. Musikvideos, KI-Effekte und Render-Ergebnisse jederzeit abrufbar.

Loslegen

MEHR KI-FEATURES ENTDECKEN