TransformezClaudeClaudeen moteur de clips musicaux

Connectez freebeat à Claude, Cursor, Windsurf et Claude Code, puis générez des clips musicaux et des effets IA directement depuis vos conversations.

API Keys
1

Ouvrir la configuration Claude Desktop

Lancez Claude Desktop et ouvrez la configuration locale du serveur MCP.
Claude Desktop
2

Ajouter le serveur MCP freebeat

Nommez-le freebeat et ajoutez la commande locale du serveur MCP :
3

Définir FREEBEAT_API_KEY

Créez une API Key dans freebeat, ajoutez-la à l’environnement MCP, puis demandez à Claude de lancer une tâche de clip musical.
API Keys → Profil

LE JEU DE COMMANDES

auth

Enregistrez et inspectez votre API Key freebeat localement, ou passez --api-key par commande si besoin.

set-api-keyshow--api-key

assets

Importez de l’audio depuis un fichier local ou une URL source, puis ajoutez une ou deux images de référence.

upload-audioupload-imagemusic_id

effects

Listez les effets vidéo disponibles et consultez effect_id, médias d’aperçu, musique par défaut et formats.

listeffect_idpreview

mv

Soumettez ou lancez une génération de clip IA avec chanson importée, prompt, références et format.

submitrun--json

effect

Générez des clips à partir de modèles d’effet avec effect_id, music_id, URL d’image et prompt.

submitruneffect_id

task

Vérifiez le statut, attendez la fin et récupérez video_url et cover_url depuis les tâches terminées.

statuswaitresult

UN STUDIO COMPLET DE CLIPS MUSICAUX DANS CLAUDE

Génération de clips musicaux, effets IA, import de médias et gestion de tâches dans une seule connexion

Terminal

> Génère un clip ville néon pour ce morceau

--aspect 9:16

--reference cover.png

 

● freebeat

Import audio...

Création de la tâche clip musical...

→ ./output/neon_mv.mp4

MÉDIAS GÉNÉRATIFS

GÉNÉRATION DE CLIPS MUSICAUX

Partez d’une chanson, d’un prompt ou d’un lien musical et laissez votre agent appeler freebeat pour générer un MV complet avec formats, références, effets et résultats de rendu asynchrones.

MOTEUR D’EFFETS

UN PROMPT TRANSFORME LA MUSIQUE EN SHORTS

Demandez à votre agent de trouver le bon effet vidéo, d’ajouter musique, images de référence et prompts, puis de générer des clips prêts pour campagnes et réseaux sociaux.

Agent

> Trouve des effets pour un teaser de lancement produit

 

● freebeat

8 effets correspondants trouvés.

Génération de 3 variantes vidéo...

✓ teaser vertical

✓ clip social carré

Modes

upload_audio Importer audio ou URL source

upload_image Ajouter une ou deux références

list_effects Voir les options effect_id

generate_music_video Lancer une tâche MV

generate_effect Lancer une tâche d’effet

get_task_status Suivre le statut de tâche

get_task_result Récupérer video_url + cover_url

MODES

CHOISISSEZ UN EFFET, ÉVITEZ LA CONFIGURATION

Démarrez avec effect_id, musique par défaut, références recommandées et instructions de modèle. Votre agent peut comparer les modèles avant de générer.

AUTOMATISATION

DU DOSSIER DE CHANSONS AU PIPELINE VIDÉO

CLI et MCP partagent le même modèle de tâches. Utilisez Claude pour la planification créative, puis importez, générez, attendez et sauvegardez du JSON structuré depuis des scripts terminal.

Terminal

> Crée 5 clips musicaux depuis ./songs

 

● freebeat

Lecture du dossier...

Soumission des jobs...

✓ 5 task ids enregistrés

✓ results.json prêt

UN STUDIO COMPLET DE CLIPS MUSICAUX DANS VOTRE AGENT

Import audio, références image, modèles d’effets et résultats de rendu dans une seule connexion MCP

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

Import de l’audio et de l’image de référence...

Création de la tâche clip musical...

 

✓ music_id 123

✓ task_id task-8H4n2

✓ status pending

 

✓ JSON prêt pour le suivi

Tous vos assets musicaux

Transformez toute URL de chanson, fichier audio local, référence produit ou brief de campagne en workflow vidéo terminé.

Terminal

$ freebeat effects list --json

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

 

→ chargement des modèles d’effet...

 

● freebeat

 

effect_id 12 sélectionné

image_url par défaut sélectionnée

music_id par défaut

prompt kinetic neon chorus

 

payload de tâche prêt

Votre style dans chaque prompt

Les images de référence et prompts réutilisables gardent une direction visuelle cohérente entre MV et effets.

Terminal

$ freebeat task wait task-8H4n2

$ freebeat task result task-8H4n2 --json

 

● freebeat

statut pending → completed

 

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

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

✓ metadata.json écrit

Résultats prêts pour l’automatisation

Task IDs, vérifications de statut, URLs vidéo, URLs de couverture et erreurs structurées sont retournés pour scripts et agents.

Terminal

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

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

 

● freebeat

Lecture des métadonnées source...

Soumission des tâches de clips asynchrones...

 

✓ task_id task-101

✓ task_id task-102

✓ results.json prêt

Variantes de clips à grande échelle

Générez coupes de campagne, boucles courtes et versions avec effets tout en gardant chaque résultat organisé pour la publication.

DU CONCEPT AU CONTENU EN UNE CONVERSATION

Dites à Claude ce que vous créez. Il choisit les bons outils MCP freebeat et livre des résultats de clips musicaux prêts pour la production

DE L’IDÉE AU CLIP MUSICAL EN UNE CONVERSATION

Commencez simplement avec une génération ou allez plus loin avec découverte d’effets, références, jobs par lot et suivi des tâches. Claude gère le workflow

Création d’assets

Soumettez une tâche de clip en quelques secondes

Décrivez l’ambiance, le format et la source musicale. Claude choisit l’outil MCP freebeat et retourne le task_id.

Génère un MV cyberpunk 9:16 pour ce morceau
Production complète

Construisez un pack de sortie depuis une conversation

Créez un MV principal, une coupe carrée et des variations courtes tout en gardant la même direction visuelle.

Fais trois coupes sociales et enregistre tous les liens vidéo
Automatisation

Comparez les effets et livrez le meilleur résultat

Listez les effets freebeat, générez des variantes, attendez la fin et choisissez la sortie la plus forte.

Essaie 4 effets et montre-moi les vidéos terminées

D’AUTRES QUESTIONS ?

Nous avons répondu aux questions les plus fréquentes

Comment freebeat se connecte-t-il aux agents IA ?

Ajoutez le serveur MCP freebeat à n’importe quel client compatible MCP. La commande est npx -y freebeat-mcp, autorisée avec la variable d’environnement FREEBEAT_API_KEY.

Où créer une API Key ?

Connectez-vous à freebeat et ouvrez /music-video-generator/profile. Créez une clé dans la section API Keys. Le lien API Keys de cette page y mène.

Quels agents sont pris en charge ?

Claude Desktop, Cursor, Windsurf, Claude Code et les autres clients compatibles MCP peuvent utiliser la même configuration serveur freebeat.

Quelle est la différence entre MCP et CLI ?

MCP sert aux conversations avec agents. La CLI sert aux terminaux et scripts. Les deux exposent imports, effets, génération, polling et récupération des résultats.

Pourquoi les générations nécessitent-elles du polling ?

Le rendu d’un clip musical peut prendre du temps. freebeat retourne d’abord un task_id, puis l’agent ou la CLI suit le statut et récupère video_url une fois terminé.

Que puis-je créer ?

Vous pouvez créer clips musicaux, clips avec modèles d’effets, vidéos sociales verticales, MV panoramiques et versions guidées par style avec images de référence.

Dois-je mettre mon API Key dans mes prompts ?

Non. Gardez la clé dans votre configuration d’environnement MCP ou vos identifiants CLI. Votre prompt doit seulement décrire la tâche créative.

Puis-je utiliser le résultat en automatisation ?

Oui. Les tâches terminées retournent des liens et champs de statut structurés qui fonctionnent bien avec fichiers JSON, feuilles de calcul, calendriers de contenu et scripts.

VOTRE STACK IA PASSE AU NIVEAU SUPÉRIEUR

Connectez Claude, Cursor, Windsurf ou Claude Code à freebeat en quelques secondes. Clips musicaux, effets IA et résultats de rendu à la demande.

Commencer

EXPLORER PLUS DE FONCTIONNALITÉS IA