Udviklere

API-dokumentation

Alt du behøver for at bygge med MeloLab API: godkendelse, kreditter, generering, jobs, webhooks og bibliotekssøgning.

Kom godt i gang

Godkend hver anmodning med din API-nøgle via headeren Authorization: Bearer. Basis-URL’en er https://melolab.ai. Læse-endpoints bruger ingen kreditter; oprettelse af en generering bruger dine eksisterende MeloLab-kreditter med de samme omkostnings- og refusionsregler som webappen. Send en Idempotency-Key-header, når du opretter en generering, så gentagne forsøg er sikre. Vellykkede svar er pakket ind i et data-objekt; fejl returnerer code, message og request_id.

Konto

Læs din API-profil, kreditsaldo og seneste forbrug.

GET/api/v1/meprofile:read

Returnerer den godkendte API-profil, inklusive kontoniveau og API-tilgængelighed.

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

Returnerer din eksisterende MeloLab-kreditsaldo. Bruger ingen kreditter.

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

Returnerer et forbrugsresumé og seneste, anonymiserede anmodningshændelser.

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

Modeller

Vis tilgængelige MeloLab-modeller og deres kreditomkostning.

GET/api/v1/modelsmodels:read

Viser tilgængelige MeloLab-modeller med deres kreditomkostning.

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

Returnerer én model via id.

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

Genereringer

Opret en musikgenerering, vis seneste genereringer, og poll et job, indtil det er færdigt.

POST/api/v1/generationsgenerations:create

Opretter en asynkron musikgenerering. Bruger dine eksisterende MeloLab-kreditter; kræver en Idempotency-Key-header.

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

Viser dine seneste genereringsjobs.

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

Poller en generering og returnerer dens numre, når den er færdig.

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

Poller et asynkront job (musik, stem-opdeling eller vokalfjernelse) og returnerer output, når udbyderen er færdig.

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

Bibliotek

Søg efter afspilbare numre og playlister, og læs detaljer om enkelte numre eller playlister.

GET/api/v1/library/searchlibrary:read

Søger efter afspilbare numre og playlister, inklusive dine egne private elementer.

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

Returnerer afspilbare metadata for et nummer.

curl -X GET https://melolab.ai/api/v1/tracks/track_123 \
  -H "Authorization: Bearer $MELOLAB_API_KEY"
GET/api/v1/playlistslibrary:read

Viser de playlister, du har adgang til.

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

Returnerer en playliste og dens numre.

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

Webhooks

Registrér HTTPS-endpoints for at få besked, når asynkrone jobs er færdige, så du slipper for at polle. Den fulde signeringshemmelighed vises kun én gang, når du opretter et endpoint.

GET/api/v1/webhook-endpoints

Viser dine aktive webhook-endpoints.

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

Registrerer et offentligt HTTPS-webhook-endpoint. Signeringshemmeligheden returneres kun én gang.

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}

Opdaterer et webhook-endpoints 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}

Sletter et webhook-endpoint.

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

Logfiler

Gennemgå API-anmodningslogfiler fra de seneste 30 dage.

GET/api/v1/logs

Viser API-anmodningslogfiler fra de seneste 30 dage.

curl -X GET https://melolab.ai/api/v1/logs?limit=20 \
  -H "Authorization: Bearer $MELOLAB_API_KEY"

Hastighedsgrænser

Læse-endpoints tillader 600 anmodninger i minuttet (50.000 om dagen). Musikgenerering tillader 12 anmodninger i minuttet (500 om dagen). Godkendelse er begrænset til 120 anmodninger i minuttet pr. IP. Overskridelse af en grænse returnerer 429 rate_limited.

Fejl

Fejl returnerer en HTTP-status plus en JSON-body { error: { code, message, request_id } }. Angiv request_id, når du kontakter support.

StatusKodeBetydning
401authentication_requiredDer blev ikke angivet nogen API-nøgle i Authorization-headeren.
401invalid_api_keyAPI-nøglen er ugyldig eller tilbagekaldt.
403insufficient_scopeAPI-nøglen mangler et påkrævet scope.
400invalid_requestAnmodningens body eller parametre er ugyldige.
400invalid_modelDet anmodede model-id findes ikke.
402insufficient_creditsIkke nok MeloLab-kreditter til at oprette denne generering.
409idempotency_conflictIdempotency-Key blev genbrugt med en anden anmodnings-body.
404not_foundDen anmodede ressource blev ikke fundet eller tilhører ikke dig.
429rate_limitedFor mange anmodninger; sæt farten ned, og prøv igen senere.
502provider_unavailableDen opstrøms udbyder er midlertidigt utilgængelig.

Start gratis

Intet kreditkort kræves. Kom i gang på få sekunder.

Se alle prisdetaljer
MeloLabMeloLab

Beskriv stil, stemning, instrumenter eller tekst og skab downloadbar AI-musik på sekunder.

ServicevilkårPrivatlivRefusion

© 2026 MeloLab. Alle rettigheder forbeholdes.