Entwickler-API

Die KI-Musikgenerator-API für Entwickler

Erzeuge originale Instrumentaltracks oder gesungene Songs aus einer Stilbeschreibung und deinem Songtext. Starte mit cURL oder TypeScript, oder binde Cursor, Claude Code und Codex über MCP an.

Verfügbar in den Plänen Pro und Ultra, Nutzung wird über Credits abgerechnet.

cURL-Quickstart

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/generationsAPI-Key erstellen
Für Entwickler und Agents gebaut

Eine KI-Musik-API, die sich in deinen Workflow einfügt

Von einem Request zum gehosteten Track — mit eigenem Code, per SDK oder über den Coding-Agent, den du ohnehin nutzt.
Lacuna-API-Request, der einen kompletten KI-generierten Musiktrack mit gehostetem Audio liefert

Komplette Tracks aus einem einzigen Request

  • Beschreibe Stil und Titel, die du brauchst
  • Wähle den Instrumental-Modus oder liefere eigene Songtexte
  • Erhalte fertige Tracks mit gehostetem Audio und Metadaten
Cursor, Claude Code und Codex nutzen die Lacuna-Dokumentation, um KI-Musikgenerierung einzubauen

Cursor, Claude Code und Codex anbinden

  • Starte den offiziellen lacuna-mcp-Server direkt aus npm
  • Trage einen API-Key in die MCP-Konfiguration deines Coding-Agents ein
  • Frag in normaler Sprache nach Musik und bekomm einen gehosteten Track
Coding-Agent einrichten
TypeScript-SDK- und REST-API-Code mit typisierten Feldern und Fehlern für die Musikgenerierung

REST, TypeScript, CLI oder MCP nutzen

  • Ruf die REST-API aus jeder Backend-Sprache auf
  • Nutze typisierte create-, retrieve- und waitFor-Methoden ab Node.js 18
  • Prüfe Webhook-Signaturen mit dem offiziellen SDK
KI-Musikgenerierung wandert von Warteschlange über Verarbeitung zu fertig und sendet einen signierten Webhook

Auf einem klaren asynchronen Lebenszyklus aufbauen

  • Task anlegen und pollen oder waitFor aufrufen
  • Signierte job.completed- und job.failed-Webhooks empfangen
  • Credits werden bei fehlgeschlagener Generierung automatisch erstattet
Wähle deine Integration

Fang mit der Schnittstelle an, die zu deinem Stack passt

Dieselbe Lacuna Music API steht über direkte HTTP-Aufrufe, ein typisiertes SDK, Kommandozeilen-Tools und einen MCP-Server für Cursor, Claude Code, Codex und andere Coding-Agents bereit.

REST-API

Ruf die HTTP-Endpoints aus jeder Sprache auf und sieh dir jeden Request und jede Response in der OpenAPI-Referenz an.

API-Referenz ansehen

TypeScript-SDK

Lege Generierungen mit typisierten Methoden an und ruf sie ab — inklusive waitFor-Polling, strukturierten Fehlern und Webhook-Prüfung.

Quickstart lesen

Kommandozeile

Erzeuge und verfolge Tracks im Terminal mit der Lacuna-Toolkit-CLI.

CLI-Setup ansehen

MCP für KI-Agents

Gib kompatiblen Coding-Agents über den Lacuna-MCP-Server Zugriff auf die Musikgenerierung.

Mit KI-Agents nutzen
Einsatzbereiche

Zwei grobe Workflows, eine Generierungs-API

Setz fertige Tracks in interaktiven Produkten ein oder automatisiere die Musikproduktion hinter deinen Content- und Agent-Workflows.

Musik-App und Spiele-Prototyp mit KI-generierten Instrumentaltracks von Lacuna
01

Musik-Apps und Spiele

Lass deine Nutzer originale Tracks erzeugen, Prototypen vertonen und Musik für interaktive Szenen bauen, ohne dein Produkt zu verlassen.

Automatisierter Video-, Podcast- und Coding-Agent-Workflow erhält generierte Musik von Lacuna
02

Content- und Agent-Workflows

Automatisiere originale Musik für Videos, Podcasts, Kampagnen-Assets, Playlists und Tasks, die dein Coding-Agent anstößt.

FAQ

Fragen zur KI-Musik-API

Aktuelle Details zu Zugang, Generierung, Abrechnung und Integration.

Die API erzeugt komplette Instrumentaltracks oder gesungene Songs. Jeder Request enthält einen Titel und eine Stilbeschreibung; für gesungene Generierungen liefert deine Anwendung zusätzlich den Songtext.

Nein. Bei einer gesungenen Generierung liefert deine Anwendung den Text. Nutze die separaten Songtext-Tools von Lacuna, wenn du den Text vor dem Musik-Request erstellen willst.

Nein. Beim Anlegen einer Generierung bekommst du einen asynchronen Task zurück. Du kannst den Status pollen, den waitFor-Helper des TypeScript-SDK nutzen oder die signierten Webhooks job.completed und job.failed abonnieren.

Erstelle einen API-Key in deinem Lacuna-Profil, bewahre ihn in einem Secrets-Manager auf und schick ihn als Bearer-Token. Keys lassen sich im selben Dashboard rotieren oder widerrufen.

Ja. Installiere den offiziellen lacuna-mcp-Server, trag deinen Lacuna-API-Key in die MCP-Konfiguration des Agents ein und frag in natürlicher Sprache nach Tracks. Dieselben Tools funktionieren in Cursor, Claude Code, Codex und anderen MCP-kompatiblen Clients.

Die Music API ist in den Plänen Pro und Ultra verfügbar. Die Nutzung läuft über Credits; die aktuellen Plandetails stehen auf der Preisseite.

Der Erstellungs-Endpoint erlaubt 60 Requests pro Minute und API-Key. Standardmäßig laufen bei Pro 10 und bei Ultra 20 Generierungen gleichzeitig; für einzelne Accounts können abweichende Werte gelten.

Credits werden beim Anlegen des Tasks abgezogen und bei einer fehlgeschlagenen Generierung automatisch erstattet. Typisierte Fehler und Webhook-Events lassen deine Anwendung den Fehlerfall explizit behandeln.

Songs, die während eines aktiven Pro- oder Ultra-Abonnements erzeugt wurden, sind von der kommerziellen Lizenz von Lacuna abgedeckt, und diese kommerziellen Rechte bleiben auch nach Ende des Abonnements bestehen.

Mit Lacuna bauen

Schick deinen ersten KI-Musik-API-Request

Erstell einen API-Key, kopier einen sofort lauffähigen cURL-Befehl, oder binde Cursor, Claude Code und Codex über den Lacuna-MCP-Server an.

API-Key holenPreise ansehen