Utvecklare
API-dokumentation
Allt du behöver för att bygga med MeloLab API: autentisering, krediter, generering, jobb, webhooks och bibliotekssökning.
Kom igång
Autentisera varje förfrågan med din API-nyckel via rubriken Authorization: Bearer. Bas-URL:en är https://melolab.ai. Läsändpunkter förbrukar inga krediter; att skapa en generering använder dina befintliga MeloLab-krediter med samma kostnads- och återbetalningsregler som webbappen. Skicka en Idempotency-Key-rubrik när du skapar en generering så att återförsök blir säkra. Lyckade svar omsluts av ett data-objekt; fel returnerar code, message och request_id.
Konto
Läs din API-profil, ditt kreditsaldo och din senaste användning.
Returnerar den autentiserade API-profilen, inklusive kontonivå och API-tillgänglighet.
curl -X GET https://melolab.ai/api/v1/me \
-H "Authorization: Bearer $MELOLAB_API_KEY"Returnerar ditt befintliga MeloLab-kreditsaldo. Förbrukar inga krediter.
curl -X GET https://melolab.ai/api/v1/credits \
-H "Authorization: Bearer $MELOLAB_API_KEY"Returnerar en användningssammanfattning och senaste, maskerade förfrågningshändelser.
curl -X GET https://melolab.ai/api/v1/usage \
-H "Authorization: Bearer $MELOLAB_API_KEY"Modeller
Lista tillgängliga MeloLab-modeller och deras kreditkostnad.
Listar tillgängliga MeloLab-modeller med deras kreditkostnad.
curl -X GET https://melolab.ai/api/v1/models \
-H "Authorization: Bearer $MELOLAB_API_KEY"Returnerar en modell via id.
curl -X GET https://melolab.ai/api/v1/models/suno/v5-5 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Genereringar
Skapa en musikgenerering, lista senaste genereringar och polla ett jobb tills det är klart.
Skapar en asynkron musikgenerering. Använder dina befintliga MeloLab-krediter; kräver en Idempotency-Key-rubrik.
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"}'Listar dina senaste genereringsjobb.
curl -X GET https://melolab.ai/api/v1/generations \
-H "Authorization: Bearer $MELOLAB_API_KEY"Pollar en generering och returnerar dess spår när den är klar.
curl -X GET https://melolab.ai/api/v1/generations/gen_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Pollar ett asynkront jobb (musik, stem-separering eller sångborttagning) och returnerar utdata när leverantören är klar.
curl -X GET https://melolab.ai/api/v1/jobs/job_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Bibliotek
Sök efter spelbara spår och spellistor och läs detaljer om enskilda spår eller spellistor.
Söker efter spelbara spår och spellistor, inklusive dina egna privata objekt.
curl -X GET https://melolab.ai/api/v1/library/search?q=lofi \
-H "Authorization: Bearer $MELOLAB_API_KEY"Returnerar spelbar metadata för ett spår.
curl -X GET https://melolab.ai/api/v1/tracks/track_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Listar de spellistor du har tillgång till.
curl -X GET https://melolab.ai/api/v1/playlists \
-H "Authorization: Bearer $MELOLAB_API_KEY"Returnerar en spellista och dess spår.
curl -X GET https://melolab.ai/api/v1/playlists/playlist_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Webhooks
Registrera HTTPS-ändpunkter för att få avisering när asynkrona jobb är klara, så att du slipper polla. Den fullständiga signeringshemligheten visas bara en gång när du skapar en ändpunkt.
Listar dina aktiva webhook-ändpunkter.
curl -X GET https://melolab.ai/api/v1/webhook-endpoints \
-H "Authorization: Bearer $MELOLAB_API_KEY"Registrerar en offentlig HTTPS-webhook-ändpunkt. Signeringshemligheten returneras bara en gång.
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"}'Uppdaterar en webhook-ändpunkts URL eller status.
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"}'Tar bort en webhook-ändpunkt.
curl -X DELETE https://melolab.ai/api/v1/webhook-endpoints/wh_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Loggar
Granska API-förfrågningsloggar från de senaste 30 dagarna.
Listar API-förfrågningsloggar från de senaste 30 dagarna.
curl -X GET https://melolab.ai/api/v1/logs?limit=20 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Hastighetsgränser
Läsändpunkter tillåter 600 förfrågningar per minut (50 000 per dag). Musikgenerering tillåter 12 förfrågningar per minut (500 per dag). Autentisering är begränsad till 120 förfrågningar per minut per IP. Att överskrida en gräns returnerar 429 rate_limited.
Fel
Fel returnerar en HTTP-status plus en JSON-body { error: { code, message, request_id } }. Ange request_id när du kontaktar supporten.
| Status | Kod | Betydelse |
|---|---|---|
| 401 | authentication_required | Ingen API-nyckel angavs i Authorization-huvudet. |
| 401 | invalid_api_key | API-nyckeln är ogiltig eller återkallad. |
| 403 | insufficient_scope | API-nyckeln saknar en obligatorisk behörighet. |
| 400 | invalid_request | Begärans body eller parametrar är ogiltiga. |
| 400 | invalid_model | Det begärda modell-id:t finns inte. |
| 402 | insufficient_credits | Inte tillräckligt med MeloLab-krediter för att skapa denna generering. |
| 409 | idempotency_conflict | Idempotency-Key återanvändes med en annan begäran-body. |
| 404 | not_found | Den begärda resursen hittades inte eller tillhör inte dig. |
| 429 | rate_limited | För många förfrågningar; sakta ner och försök igen senare. |
| 502 | provider_unavailable | Den uppströms leverantören är tillfälligt otillgänglig. |
