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.

GET/api/v1/meprofile:read

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"

GET/api/v1/creditscredits:read

Returnerar ditt befintliga MeloLab-kreditsaldo. Förbrukar inga krediter.

curl -X GET https://melolab.ai/api/v1/credits \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

GET/api/v1/usageprofile:read

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.

GET/api/v1/modelsmodels:read

Listar tillgängliga MeloLab-modeller med deras kreditkostnad.

curl -X GET https://melolab.ai/api/v1/models \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

GET/api/v1/models/{model_id}models:read

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.

POST/api/v1/generationsgenerations:create

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"}'

GET/api/v1/generationsgenerations:read

Listar dina senaste genereringsjobb.

curl -X GET https://melolab.ai/api/v1/generations \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

GET/api/v1/generations/{id}generations:read

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"

GET/api/v1/jobs/{job_id}

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.

GET/api/v1/library/searchlibrary:read

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"

GET/api/v1/tracks/{id}library:read

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"

GET/api/v1/playlistslibrary:read

Listar de spellistor du har tillgång till.

curl -X GET https://melolab.ai/api/v1/playlists \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

GET/api/v1/playlists/{id}library:read

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.

GET/api/v1/webhook-endpoints

Listar dina aktiva webhook-ändpunkter.

curl -X GET https://melolab.ai/api/v1/webhook-endpoints \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

POST/api/v1/webhook-endpoints

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"}'

PATCH/api/v1/webhook-endpoints/{id}

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"}'

DELETE/api/v1/webhook-endpoints/{id}

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.

GET/api/v1/logs

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.
401	revoked_api_key	API-nyckeln har återkallats och kan inte längre användas.
403	api_terms_not_accepted	API-kontot är inte redo eftersom API-villkoren inte har accepterats.
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.
400	idempotency_key_required	Den här förfrågan kräver en Idempotency-Key-rubrik.
409	idempotency_key_conflict	Idempotency-Key återanvändes med en annan förfrågningsform.
409	idempotency_conflict	Idempotency-Key återanvändes med en annan begäran-body.
409	generation_concurrency_exceeded	För många genereringsjobb körs redan för detta konto.
404	job_not_found	Det begärda jobbet finns inte eller tillhör inte detta konto.
404	track_not_found	Det begärda spåret finns inte eller är inte tillgängligt för detta konto.
404	playlist_not_found	Den begärda spellistan finns inte eller är inte tillgänglig för detta konto.
404	webhook_endpoint_not_found	Den begärda webhook-ändpunkten finns inte eller är inte din.
400	webhook_url_invalid	Webhook-URL:en är ogiltig.
400	webhook_https_required	Webhook-ändpunkter måste använda HTTPS.
400	webhook_credentials_forbidden	Webhook-URL:er får inte innehålla inbäddade autentiseringsuppgifter.
400	webhook_host_blocked	Webhook-URL:er får inte peka på localhost, privata eller blockerade värdar.
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.
502	provider_timeout	Den uppströms leverantören tog för lång tid.
500	generation_failed	Genereringen misslyckades efter att den accepterats.
500	internal_error	Oväntat API-plattformsfel.

API-dokumentation

Kom igång

Konto

Modeller

Genereringar

Bibliotek

Webhooks

Loggar

Hastighetsgränser

Fel

Starta gratis

Skapa

Transform

Analyze

Företag