För utvecklare
Musik-API och CLI
Förvandla en idé eller dina texter till en lÄt frÄn dina egna skript. AnvÀnd samma konto, krediter och privata bibliotek som appen.
Anslut ditt konto
- Skapa ett konto och verifiera din e-post.
- Ăppna InstĂ€llningar och skapa en API-nyckel. API-nycklar
- Förvara nyckeln pÄ din server eller i en hemlig hanterare. Skicka den som en Authorization-header, aldrig i en URL eller frontend-kod.
Nycklar upphör att gÀlla efter 90 dagar. Du kan ha fem aktiva nycklar och Äterkalla vilken nyckel som helst omedelbart i InstÀllningar. Skrivskyddade nycklar kan inte generera lÄtar.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Förbered, starta och kontrollera din lÄt
Förbered först en brief utan att spendera en kredit. Att starta den förberedelsen anvÀnder en befintlig lÄtkredit. BehÄll samma förfrÄgnings-ID vid omförsök. En timeout fÄr inte starta en annan lÄt.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "En hoppfull lÄt om att börja om i en ny stad",
"direction": "Varm akustisk pop, stadiga trummor, mjuk sÄng",
"language": "sv",
"duration": 120
},
"uiLocale": "sv"
}Skicka denna JSON till POST /v1/songs/prepare. Skicka sedan dess preparedRequestId till POST /v1/songs/start. Kontrollera GET /v1/jobs/{jobId} med minst 15 sekunders mellanrum. NÀr den Àr klar, öppna den returnerade lÀnken till det privata biblioteket för att lyssna eller ladda ner.
LÄtsprÄk som stöds Àr engelska, spanska, tyska, franska, brasiliansk portugisiska, italienska, nederlÀndska, polska, svenska, japanska och koreanska. BegÀr 60 till 180 sekunder. AnvÀnd textlÀget för din egen lÄttext eller instrumental: true för musik utan sÄng.
API-slutpunkter
| Metod och sökvÀg | à tgÀrd |
|---|---|
GET /v1/account | Kontrollera dina tillgÀngliga lÄtkrediter |
POST /v1/billing/checkout | Skapa en Stripe-kassalÀnk |
POST /v1/songs/prepare | Förbered en lÄt utan att spendera en kredit |
POST /v1/songs/start | Generera den förberedda lÄten med en befintlig kredit |
GET /v1/jobs/{jobId} | Kontrollera genereringsstatus |
GET /v1/songs | Lista ditt privata lÄtbibliotek |
GET /v1/songs/{id} | LÀs en av dina lÄtar |
API:ets bas-URL Àr https://mcp.wordsintomusic.com/v1. Ladda ner OpenAPI-specifikationen för förfrÄgningsfÀlt, grÀnser, behörigheter och svarsformat.
AnvÀnd kommandoraden
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 10AnvÀnd Node.js 22 eller senare. Skicka nyckeln för inloggning via standardinmatning, eller ange WIM_API_KEY frÄn din hemlighetshanterare. Placera den inte i kommandoradsargument eller shell-historik. Kör wim --help för detaljer.
Krediter, grÀnser och integritet
Om du behöver lÄtkrediter returnerar API:et HTTP 402. VÀlj ett erbjudande frÄn GET /v1/account, skicka sedan POST /v1/billing/checkout med ditt bekrÀftade val. Betala pÄ Stripe utan att logga in pÄ en annan webbplats. Kontrollera ditt saldo och försök igen med det ursprungliga preparedRequestId efter att betalningen har bekrÀftats.
API-Ätkomst och CLI har ingen separat prenumeration. Att generera en inspelning anvÀnder din befintliga lÄtkvot, med samma kontogrÀnser som appen. API:et debiterar dig aldrig automatiskt.
Endast nyckelÀgarens lÄtar kan lÀsas. Texter returneras endast nÀr de begÀrs. Att Äterkalla en nyckel stoppar nya API-anrop, medan en redan accepterad lÄt fortsÀtter att bearbetas.
Gatewayen tillÄter upp till 30 API-förfrÄgningar per minut per IP. API- och MCP-anrop delar ocksÄ en kontogrÀns pÄ 120 förfrÄgningar per minut. Respektera Retry-After vid ett 429-svar. Lyckade förberedelse-ID:n förblir tillgÀngliga för omförsöksskydd i 30 dagar efter utgÄngen.
För assistentanslutningar, anvÀnd vÄr MCP installationsguide. För kontokvoter, se PrissÀttning.
