Kehittäjät
API-dokumentaatio
Kaikki mitä tarvitset MeloLab API:lla rakentamiseen: todennus, krediitit, generointi, työt, webhookit ja kirjastohaku.
Aloitus
Todenna jokainen pyyntö API-avaimellasi Authorization: Bearer -otsakkeella. Perus-URL on https://melolab.ai. Luku-päätepisteet eivät kuluta krediittejä; generoinnin luominen käyttää olemassa olevia MeloLab-krediittejäsi samoilla kustannus- ja hyvityssäännöillä kuin verkkosovellus. Lähetä Idempotency-Key-otsake generointia luodessasi, jotta uudelleenyritykset ovat turvallisia. Onnistuneet vastaukset on kääritty data-objektiin; virheet palauttavat code-, message- ja request_id-kentät.
Tili
Lue API-profiilisi, krediittisaldosi ja viimeaikainen käyttö.
Palauttaa todennetun API-profiilin, mukaan lukien tilitason ja API:n saatavuuden.
curl -X GET https://melolab.ai/api/v1/me \
-H "Authorization: Bearer $MELOLAB_API_KEY"Palauttaa olemassa olevan MeloLab-krediittisaldosi. Ei kuluta krediittejä.
curl -X GET https://melolab.ai/api/v1/credits \
-H "Authorization: Bearer $MELOLAB_API_KEY"Palauttaa käyttöyhteenvedon ja viimeaikaiset, anonymisoidut pyyntötapahtumat.
curl -X GET https://melolab.ai/api/v1/usage \
-H "Authorization: Bearer $MELOLAB_API_KEY"Mallit
Listaa saatavilla olevat MeloLab-mallit ja niiden krediittikustannus.
Listaa saatavilla olevat MeloLab-mallit ja niiden krediittikustannuksen.
curl -X GET https://melolab.ai/api/v1/models \
-H "Authorization: Bearer $MELOLAB_API_KEY"Palauttaa yhden mallin id:n perusteella.
curl -X GET https://melolab.ai/api/v1/models/suno/v5-5 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Generoinnit
Luo musiikkigenerointi, listaa viimeaikaiset generoinnit ja kysele työtä, kunnes se on valmis.
Luo asynkronisen musiikkigeneroinnin. Käyttää olemassa olevia MeloLab-krediittejäsi; vaatii Idempotency-Key-otsakkeen.
curl -X POST https://melolab.ai/api/v1/generations \
-H "Authorization: Bearer $MELOLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model_id":"suno/v5-5","prompt":"warm lofi beat for a focus playlist"}'Listaa viimeaikaiset generointityösi.
curl -X GET https://melolab.ai/api/v1/generations \
-H "Authorization: Bearer $MELOLAB_API_KEY"Kyselee generointia ja palauttaa sen kappaleet, kun se on valmis.
curl -X GET https://melolab.ai/api/v1/generations/gen_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Kyselee asynkronista työtä (musiikki, raitojen erottelu tai laulun poisto) ja palauttaa tulosteet, kun palveluntarjoaja on valmis.
curl -X GET https://melolab.ai/api/v1/jobs/job_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Kirjasto
Hae toistettavia kappaleita ja soittolistoja ja lue yksittäisten kappaleiden tai soittolistojen tiedot.
Hakee toistettavia kappaleita ja soittolistoja, mukaan lukien omat yksityiset kohteesi.
curl -X GET https://melolab.ai/api/v1/library/search?q=lofi \
-H "Authorization: Bearer $MELOLAB_API_KEY"Palauttaa kappaleen toistettavat metatiedot.
curl -X GET https://melolab.ai/api/v1/tracks/track_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Listaa käytettävissäsi olevat soittolistat.
curl -X GET https://melolab.ai/api/v1/playlists \
-H "Authorization: Bearer $MELOLAB_API_KEY"Palauttaa soittolistan ja sen kappaleet.
curl -X GET https://melolab.ai/api/v1/playlists/playlist_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Webhookit
Rekisteröi HTTPS-päätepisteitä saadaksesi ilmoituksen, kun asynkroniset työt valmistuvat, jotta sinun ei tarvitse kysellä. Täysi allekirjoitussalaisuus näytetään vain kerran päätepistettä luotaessa.
Listaa aktiiviset webhook-päätepisteesi.
curl -X GET https://melolab.ai/api/v1/webhook-endpoints \
-H "Authorization: Bearer $MELOLAB_API_KEY"Rekisteröi julkisen HTTPS-webhook-päätepisteen. Allekirjoitussalaisuus palautetaan vain kerran.
curl -X POST https://melolab.ai/api/v1/webhook-endpoints \
-H "Authorization: Bearer $MELOLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/melolab/webhook"}'Päivittää webhook-päätepisteen URL-osoitteen tai tilan.
curl -X PATCH https://melolab.ai/api/v1/webhook-endpoints/wh_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"disabled"}'Poistaa webhook-päätepisteen.
curl -X DELETE https://melolab.ai/api/v1/webhook-endpoints/wh_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Lokit
Tarkastele viimeisen 30 päivän API-pyyntölokeja.
Listaa viimeisen 30 päivän API-pyyntölokit.
curl -X GET https://melolab.ai/api/v1/logs?limit=20 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Nopeusrajat
Luku-päätepisteet sallivat 600 pyyntöä minuutissa (50 000 päivässä). Musiikin generointi sallii 12 pyyntöä minuutissa (500 päivässä). Todennus on rajoitettu 120 pyyntöön minuutissa IP-osoitetta kohden. Rajan ylitys palauttaa 429 rate_limited.
Virheet
Virheet palauttavat HTTP-tilan sekä JSON-rungon { error: { code, message, request_id } }. Ilmoita request_id, kun otat yhteyttä tukeen.
| Tila | Koodi | Merkitys |
|---|---|---|
| 401 | authentication_required | Authorization-otsakkeessa ei annettu API-avainta. |
| 401 | invalid_api_key | API-avain on virheellinen tai peruutettu. |
| 403 | insufficient_scope | API-avaimelta puuttuu vaadittu oikeus. |
| 400 | invalid_request | Pyynnön runko tai parametrit ovat virheellisiä. |
| 400 | invalid_model | Pyydettyä malli-id:tä ei ole olemassa. |
| 402 | insufficient_credits | MeloLab-krediittejä ei ole tarpeeksi tämän generoinnin luomiseen. |
| 409 | idempotency_conflict | Idempotency-Key käytettiin uudelleen eri pyyntörungolla. |
| 404 | not_found | Pyydettyä resurssia ei löytynyt tai se ei ole sinun. |
| 429 | rate_limited | Liikaa pyyntöjä; hidasta ja yritä myöhemmin uudelleen. |
| 502 | provider_unavailable | Ylävirran palveluntarjoaja ei ole tilapäisesti käytettävissä. |
