01
Applis musicales et jeux
Laisse tes utilisateurs générer des morceaux originaux, habiller des prototypes et créer la musique de scènes interactives sans quitter ton produit.
API développeur
L'API de génération de musique IA pour les développeurs
Génère des instrumentaux originaux ou des chansons chantées à partir d'une description de style et de tes paroles. Commence en cURL ou TypeScript, ou connecte Cursor, Claude Code et Codex via MCP.
Disponible sur les forfaits Pro et Ultra, avec une consommation en crédits.
Démarrage rapide en cURL
Terminal
curl https://www.lacuna.fm/api/v1/music/generations \
-H "Authorization: Bearer $LACUNA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"style": "lofi hip hop, mellow piano, 70 bpm",
"title": "Late Night Study",
"instrumental": true,
"model": "aether"
}'POST /api/v1/music/generationsCréer une clé APIConçue pour les développeurs et les agents
Une API de génération musicale qui s'intègre à ton workflow
D'une requête à un morceau hébergé, en écrivant le code toi-même, via le SDK ou avec l'agent de code que tu utilises déjà.
Des morceaux complets en une seule requête
- Décris le style et le titre voulus
- Choisis le mode instrumental ou fournis tes propres paroles
- Reçois des morceaux complets avec audio hébergé et métadonnées
Connecte Cursor, Claude Code et Codex
- Lance le serveur officiel lacuna-mcp directement depuis npm
- Ajoute une clé API à la configuration MCP de ton agent de code
- Demande de la musique en langage naturel et reçois un morceau hébergé
REST, TypeScript, CLI ou MCP, au choix
- Appelle l'API REST depuis n'importe quel langage backend
- Utilise les méthodes typées create, retrieve et waitFor sur Node.js 18+
- Vérifie les signatures de webhook avec le SDK officiel
Développe sur un cycle asynchrone clair
- Crée une tâche puis interroge son état ou appelle waitFor
- Reçois les webhooks signés job.completed et job.failed
- Récupère automatiquement tes crédits quand une génération échoue
Choisis ton intégration
Pars de l'interface qui colle à ta stack
La même Lacuna Music API est accessible par appels HTTP directs, via un SDK typé, en ligne de commande, et par un serveur MCP pour Cursor, Claude Code, Codex et les autres agents de code.
API REST
Appelle les endpoints HTTP depuis n'importe quel langage et inspecte chaque requête et réponse dans la référence OpenAPI.
Voir la référence de l'APISDK TypeScript
Crée et récupère des générations avec des méthodes typées, du polling waitFor, des erreurs structurées et la vérification des webhooks.
Lire le guide de démarrageLigne de commande
Génère et suis tes morceaux depuis un terminal avec la CLI Lacuna Toolkit.
Voir la configuration CLIMCP pour agents IA
Donne aux agents de code compatibles l'accès à la génération musicale via le serveur MCP de Lacuna.
Utiliser avec des agents IACas d'usage
Deux grands workflows, une seule API de génération
Intègre des morceaux complets dans des produits interactifs ou automatise la production musicale derrière tes workflows de contenu et d'agents.
02
Workflows de contenu et d'agents
Automatise la musique originale de tes vidéos, podcasts, contenus de campagne, playlists et des tâches lancées par ton agent de code.
FAQ
Questions sur l'API de musique IA
Accès, génération, facturation et intégration : les détails à jour.
L'API crée des instrumentaux complets ou des chansons chantées. Chaque requête comprend un titre et une description de style ; les générations chantées demandent en plus les paroles fournies par ton application.
Non. Pour une génération chantée, c'est ton application qui fournit les paroles. Utilise les outils de paroles de Lacuna si tu dois les écrire avant d'envoyer la requête musicale.
Non. Créer une génération renvoie une tâche asynchrone. Tu peux interroger son statut, utiliser le helper waitFor du SDK TypeScript, ou t'abonner aux webhooks signés job.completed et job.failed.
Crée une clé API depuis ton profil Lacuna, conserve-la dans un gestionnaire de secrets et envoie-la comme jeton Bearer. Les clés se font tourner ou se révoquent depuis le même tableau de bord.
Oui. Installe le serveur officiel lacuna-mcp, ajoute ta clé API Lacuna à la configuration MCP de l'agent, puis demande des morceaux en langage naturel. Les mêmes outils fonctionnent dans Cursor, Claude Code, Codex et les autres clients compatibles MCP.
La Music API est disponible sur les forfaits Pro et Ultra. La consommation se fait en crédits ; le détail à jour de chaque forfait figure sur la page tarifs.
L'endpoint de création accepte 60 requêtes par minute et par clé API. Les limites de générations simultanées sont par défaut de 10 tâches en Pro et 20 en Ultra ; des valeurs spécifiques peuvent s'appliquer selon le compte.
Les crédits sont débités à la création de la tâche et remboursés automatiquement si la génération échoue. Les erreurs typées et les événements webhook permettent à ton application de traiter l'échec explicitement.
Les morceaux générés pendant un abonnement Pro ou Ultra actif sont couverts par la licence commerciale Lacuna, et ces droits commerciaux restent acquis après la fin de l'abonnement.
Construis avec Lacuna
Envoie ta première requête à l'API de musique IA
Crée une clé API, copie une commande cURL prête à l'emploi, ou connecte Cursor, Claude Code et Codex via le serveur MCP de Lacuna.