Für Entwickler
Musik-API und CLI
Verwandle mit eigenen Skripten eine Idee oder deinen Text in einen Song. Nutze dasselbe Konto, Guthaben und dieselbe private Bibliothek wie in der App.
Verbinde dein Konto
- Konto erstellen und bestätige deine E-Mail-Adresse.
- Öffne die Einstellungen und erstelle einen API-Schlüssel. API-Schlüssel
- Bewahre den Schlüssel auf deinem Server oder in deiner Geheimnisverwaltung auf. Sende ihn im Authorization-Header, niemals in einer URL oder im Frontend-Code.
Schlüssel laufen nach 90 Tagen ab. Du kannst fünf aktive Schlüssel haben und jeden davon in den Einstellungen sofort widerrufen. Leseschlüssel können keine Songs erstellen.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Song vorbereiten, starten und prüfen
Bereite zuerst die Vorgaben vor, ohne Guthaben zu verbrauchen. Der Start verwendet ein vorhandenes Songguthaben. Behalte bei Wiederholungen dieselbe Anfrage-ID. Eine Zeitüberschreitung darf keinen weiteren Song starten.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "Ein hoffnungsvoller Song über einen Neuanfang in einer neuen Stadt",
"direction": "Warmer Akustik-Pop, gleichmäßiges Schlagzeug, sanfter Gesang",
"language": "de",
"duration": 120
},
"uiLocale": "de"
}Sende dieses JSON an POST /v1/songs/prepare. Sende danach die erhaltene preparedRequestId an POST /v1/songs/start. Frage GET /v1/jobs/{jobId} frühestens alle 15 Sekunden ab. Öffne anschließend den privaten Bibliothekslink zum Anhören oder Herunterladen.
Unterstützt werden Englisch, Spanisch, Deutsch, Französisch und brasilianisches Portugiesisch. Wähle 60 bis 180 Sekunden. Verwende den Modus lyrics für eigene Texte oder instrumental: true für Musik ohne Gesang.
API-Endpunkte
| Methode und Pfad | Aktion |
|---|---|
GET /v1/account | Verfügbares Songguthaben prüfen |
POST /v1/songs/prepare | Song ohne Guthabenverbrauch vorbereiten |
POST /v1/songs/start | Vorbereiteten Song mit einem vorhandenen Guthaben erstellen |
GET /v1/jobs/{jobId} | Erstellungsstatus prüfen |
GET /v1/songs | Private Songbibliothek auflisten |
GET /v1/songs/{id} | Einen deiner Songs abrufen |
Die Basis-URL der API lautet https://mcp.wordsintomusic.com/v1. OpenAPI-Spezifikation herunterladen für Anfragefelder, Limits, Berechtigungen und Antwortformate.
Befehlszeile verwenden
npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10Verwende Node.js 22 oder neuer. Übergib den Schlüssel über die Standardeingabe an login oder stelle WIM_API_KEY über deine Geheimnisverwaltung bereit. Schreibe ihn nicht in Befehlsargumente oder den Shell-Verlauf. Details zeigt wim --help.
Guthaben, Limits und Datenschutz
API-Zugang und CLI benötigen kein separates Abo. Eine Aufnahme verwendet dein vorhandenes Songguthaben mit denselben Kontolimits wie die App. Die API kauft niemals Guthaben und schließt kein Abo ab.
Nur Songs des Schlüsselinhabers sind abrufbar. Texte werden nur auf Anfrage zurückgegeben. Ein Widerruf blockiert neue API-Aufrufe; bereits angenommene Songs werden weiter erstellt.
Das Gateway erlaubt bis zu 30 API-Anfragen pro Minute und IP. API und MCP teilen sich zusätzlich ein Kontolimit von 120 Anfragen pro Minute. Beachte Retry-After bei einer 429-Antwort. IDs gestarteter Vorbereitungen bleiben bis 30 Tage nach Ablauf zur Vermeidung doppelter Starts verfügbar.
Für Assistentenverbindungen nutze unsere MCP-Einrichtung. Die Kontingente findest du unter Preise.
