Voor ontwikkelaars
Muziek-API en CLI
Verander een idee of je teksten in een nummer vanuit je eigen scripts. Gebruik hetzelfde account, credits en privébibliotheek als de app.
Verbind je account
- Maak een account aan en verifieer je e-mail.
- Open Instellingen en maak een API-sleutel aan. API-sleutels
- Bewaar de sleutel op je server of in je secret manager. Stuur deze als een Authorization header, nooit in een URL of frontend code.
Sleutels verlopen na 90 dagen. Je kunt vijf actieve sleutels hebben en elke sleutel direct intrekken in Instellingen. Alleen-lezen sleutels kunnen geen nummers genereren.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Je nummer voorbereiden, starten en controleren
Bereid eerst een briefing voor zonder een credit uit te geven. Het starten van die voorbereiding gebruikt één bestaande nummercredit. Gebruik dezelfde aanvraag-ID bij een nieuwe poging. Een time-out mag geen ander nummer starten.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "Een hoopvol nummer over opnieuw beginnen in een nieuwe stad",
"direction": "Warme akoestische pop, stabiele drums, zachte zang",
"language": "nl",
"duration": 120
},
"uiLocale": "nl"
}Stuur deze JSON naar POST /v1/songs/prepare. Stuur vervolgens de preparedRequestId naar POST /v1/songs/start. Controleer GET /v1/jobs/{jobId} met een tussenpoos van minimaal 15 seconden. Zodra het klaar is, open je de ontvangen link naar je privébibliotheek om te luisteren of te downloaden.
Ondersteunde songtalen zijn Engels, Spaans, Duits, Frans, Braziliaans Portugees, Italiaans, Nederlands, Pools, Zweeds, Japans en Koreaans. Vraag een lengte van 60 tot 180 seconden aan. Gebruik de songtekstmodus voor je eigen tekst, of instrumental: true voor muziek zonder zang.
API-eindpunten
| Methode en pad | Actie |
|---|---|
GET /v1/account | Controleer je beschikbare nummercredits |
POST /v1/billing/checkout | Maak een Stripe-betaallink aan |
POST /v1/songs/prepare | Bereid een nummer voor zonder een credit uit te geven |
POST /v1/songs/start | Genereer het voorbereide nummer met één bestaande credit |
GET /v1/jobs/{jobId} | Controleer de generatiestatus |
GET /v1/songs | Toon je privé nummerbibliotheek |
GET /v1/songs/{id} | Lees een van je nummers |
De basis-URL van de API is https://mcp.wordsintomusic.com/v1. Download de OpenAPI-specificatie voor aanvraagvelden, limieten, machtigingen en antwoordformaten.
Gebruik de commandoregel
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 10Gebruik Node.js 22 of nieuwer. Geef de sleutel door voor het inloggen via standaardinvoer, of lever de WIM_API_KEY aan vanuit je secret manager. Plaats deze niet in commandoargumenten of shellgeschiedenis. Voer wim --help uit voor details.
Credits, limieten en privacy
Als je nummercredits nodig hebt, retourneert de API HTTP 402. Kies een aanbod uit GET /v1/account, stuur dan POST /v1/billing/checkout met je bevestigde keuze. Betaal op Stripe zonder opnieuw in te loggen op een andere website. Controleer je saldo en probeer de originele preparedRequestId opnieuw nadat de betaling is bevestigd.
API-toegang en de CLI hebben geen apart abonnement. Het genereren van een opname gebruikt je bestaande nummertegoed, met dezelfde accountlimieten als de app. De API brengt je nooit automatisch kosten in rekening.
Alleen de nummers van de sleuteleigenaar kunnen worden gelezen. Songteksten worden alleen teruggestuurd wanneer aangevraagd. Het intrekken van een sleutel stopt nieuwe API-aanroepen, terwijl een reeds geaccepteerd nummer wel wordt verwerkt.
De gateway staat maximaal 30 API-aanvragen per minuut per IP toe. API- en MCP-aanroepen delen ook een accountlimiet van 120 aanvragen per minuut. Respecteer Retry-After bij een 429-antwoord. Succesvolle voorbereidings-ID's blijven 30 dagen na afloop beschikbaar voor bescherming bij herhaalpogingen.
Voor assistent-verbindingen, gebruik onze MCP installatiegids. Voor accounttegoeden, zie Prijzen.
