Dla programistów
API i CLI muzyki
Przekształć pomysł lub swoje teksty w piosenkę za pomocą własnych skryptów. Użyj tego samego konta, kredytów i prywatnej biblioteki co w aplikacji.
Połącz swoje konto
- Utwórz konto i zweryfikuj swój adres e-mail.
- Otwórz Ustawienia i utwórz klucz API. Klucze API
- Przechowuj klucz na swoim serwerze lub w menedżerze sekretów. Wysyłaj go jako nagłówek Authorization, nigdy w adresie URL ani w kodzie frontendowym.
Klucze wygasają po 90 dniach. Możesz mieć pięć aktywnych kluczy i natychmiast odwołać dowolny klucz w Ustawieniach. Klucze tylko do odczytu nie mogą generować utworów.
curl https://mcp.wordsintomusic.com/v1/account \
-H "Authorization: Bearer $WIM_API_KEY"Przygotuj, rozpocznij i sprawdź swój utwór
Najpierw przygotuj brief bez wydawania kredytu. Rozpoczęcie tego przygotowania zużywa jeden istniejący kredyt na utwór. Zachowaj ten sam identyfikator żądania podczas ponawiania próby. Przekroczenie czasu nie może rozpocząć kolejnego utworu.
{
"requestId": "my-first-song-20261021",
"input": {
"mode": "idea",
"idea": "Piosenka pełna nadziei o zaczynaniu od nowa w nowym mieście",
"direction": "Ciepły akustyczny pop, stabilne bębny, delikatne wokale",
"language": "pl",
"duration": 120
},
"uiLocale": "pl"
}Wyślij ten JSON do POST /v1/songs/prepare. Następnie wyślij jego preparedRequestId do POST /v1/songs/start. Sprawdzaj GET /v1/jobs/{jobId} co najmniej co 15 sekund. Gdy będzie gotowy, otwórz zwrócony prywatny link do biblioteki, aby posłuchać lub pobrać.
Obsługiwane języki utworów to angielski, hiszpański, niemiecki, francuski, portugalski brazylijski, włoski, niderlandzki, polski, szwedzki, japoński i koreański. Wybierz długość od 60 do 180 sekund. Użyj trybu tekstu piosenki dla własnego tekstu lub instrumental: true dla muzyki bez wokalu.
Punkty końcowe API
| Metoda i ścieżka | Działanie |
|---|---|
GET /v1/account | Sprawdź dostępne kredyty na utwory |
POST /v1/billing/checkout | Utwórz link do płatności Stripe |
POST /v1/songs/prepare | Przygotuj utwór bez wydawania kredytu |
POST /v1/songs/start | Wygeneruj przygotowany utwór, używając jednego istniejącego kredytu |
GET /v1/jobs/{jobId} | Sprawdź status generowania |
GET /v1/songs | Wyświetl swoją prywatną bibliotekę utworów |
GET /v1/songs/{id} | Przeczytaj jeden ze swoich utworów |
Bazowy URL API to https://mcp.wordsintomusic.com/v1. Pobierz specyfikację OpenAPI dla pól żądań, limitów, uprawnień i formatów odpowiedzi.
Użyj wiersza poleceń
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 10Użyj Node.js 22 lub nowszego. Przekaż klucz do logowania przez standardowe wejście lub podaj WIM_API_KEY ze swojego menedżera sekretów. Nie umieszczaj go w argumentach poleceń ani historii powłoki. Uruchom wim --help, aby uzyskać szczegóły.
Kredyty, limity i prywatność
Jeśli potrzebujesz kredytów na utwory, API zwróci HTTP 402. Wybierz ofertę z GET /v1/account, a następnie POST /v1/billing/checkout z potwierdzonym wyborem. Zapłać na Stripe bez kolejnego logowania do witryny. Sprawdź swoje saldo i ponów próbę z oryginalnym preparedRequestId po potwierdzeniu płatności.
Dostęp do API i CLI nie wymaga oddzielnej subskrypcji. Generowanie nagrania wykorzystuje Twój istniejący limit utworów, z tymi samymi limitami konta co aplikacja. API nigdy nie obciąża Cię automatycznie.
Można odczytywać tylko utwory właściciela klucza. Teksty są zwracane tylko na żądanie. Odwołanie klucza zatrzymuje nowe wywołania API, podczas gdy utwór już zaakceptowany kontynuuje przetwarzanie.
Brama zezwala na maksymalnie 30 żądań API na minutę na adres IP. Wywołania API i MCP również współdzielą limit 120 żądań na konto na minutę. Przestrzegaj Retry-After w odpowiedzi 429. Pomyślne identyfikatory przygotowania pozostają dostępne do ochrony przed ponownymi próbami przez 30 dni po wygaśnięciu.
W przypadku połączeń z asystentem, użyj naszego Przewodnik konfiguracji MCP. W przypadku limitów konta, zobacz Cennik.
