Utviklere

API-dokumentasjon

Alt du trenger for å bygge med MeloLab API: autentisering, kreditter, generering, jobber, webhooks og bibliotekssøk.

Kom i gang

Autentiser hver forespørsel med API-nøkkelen din via headeren Authorization: Bearer. Basis-URL-en er https://melolab.ai. Lese-endepunkter bruker ingen kreditter; å opprette en generering bruker dine eksisterende MeloLab-kreditter med de samme kostnads- og refusjonsreglene som nettappen. Send en Idempotency-Key-header når du oppretter en generering, slik at gjentatte forsøk er trygge. Vellykkede svar er pakket inn i et data-objekt; feil returnerer code, message og request_id.

Konto

Les API-profilen din, kredittsaldoen og nylig bruk.

GET/api/v1/meprofile:read

Returnerer den autentiserte API-profilen, inkludert kontonivå og API-tilgjengelighet.

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

GET/api/v1/creditscredits:read

Returnerer din eksisterende MeloLab-kredittsaldo. Bruker ingen kreditter.

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

GET/api/v1/usageprofile:read

Returnerer et brukssammendrag og nylige, anonymiserte forespørselshendelser.

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

Modeller

List opp tilgjengelige MeloLab-modeller og kredittkostnaden deres.

GET/api/v1/modelsmodels:read

Lister opp tilgjengelige MeloLab-modeller med kredittkostnaden deres.

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 modell via id.

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

Genereringer

Opprett en musikkgenerering, list opp nylige genereringer, og poll en jobb til den er ferdig.

POST/api/v1/generationsgenerations:create

Oppretter en asynkron musikkgenerering. Bruker dine eksisterende MeloLab-kreditter; krever 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

Lister opp dine nylige genereringsjobber.

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 sporene når den er ferdig.

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

GET/api/v1/jobs/{job_id}

Poller en asynkron jobb (musikk, stem-separering eller vokalfjerning) og returnerer utdata når leverandøren er ferdig.

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

Bibliotek

Søk etter spillbare spor og spillelister, og les detaljer om enkeltspor eller spillelister.

GET/api/v1/library/searchlibrary:read

Søker etter spillbare spor og spillelister, inkludert 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 spillbare metadata for et spor.

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

GET/api/v1/playlistslibrary:read

Lister opp spillelistene du har tilgang 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 spilleliste og sporene.

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

Webhooks

Registrer HTTPS-endepunkter for å bli varslet når asynkrone jobber er ferdige, slik at du slipper å polle. Den fullstendige signeringshemmeligheten vises bare én gang når du oppretter et endepunkt.

GET/api/v1/webhook-endpoints

Lister opp dine aktive webhook-endepunkter.

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

POST/api/v1/webhook-endpoints

Registrerer et offentlig HTTPS-webhook-endepunkt. Signeringshemmeligheten returneres bare é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}

Oppdaterer URL-en eller statusen til et webhook-endepunkt.

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-endepunkt.

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

Logger

Gjennomgå API-forespørselslogger fra de siste 30 dagene.

GET/api/v1/logs

Lister opp API-forespørselslogger fra de siste 30 dagene.

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

Hastighetsgrenser

Lese-endepunkter tillater 600 forespørsler per minutt (50 000 per dag). Musikkgenerering tillater 12 forespørsler per minutt (500 per dag). Autentisering er begrenset til 120 forespørsler per minutt per IP. Overskridelse av en grense returnerer 429 rate_limited.

Feil

Feil returnerer en HTTP-status pluss en JSON-body { error: { code, message, request_id } }. Oppgi request_id når du kontakter kundestøtte.

Status	Kode	Betydning
401	authentication_required	Ingen API-nøkkel ble oppgitt i Authorization-headeren.
401	invalid_api_key	API-nøkkelen er ugyldig eller tilbakekalt.
403	insufficient_scope	API-nøkkelen mangler et påkrevd omfang.
400	invalid_request	Forespørselens body eller parametere er ugyldige.
400	invalid_model	Den forespurte modell-id-en finnes ikke.
402	insufficient_credits	Ikke nok MeloLab-kreditter til å opprette denne genereringen.
409	idempotency_conflict	Idempotency-Key ble gjenbrukt med en annen forespørsels-body.
404	not_found	Den forespurte ressursen ble ikke funnet eller tilhører ikke deg.
429	rate_limited	For mange forespørsler; senk farten og prøv igjen senere.
502	provider_unavailable	Oppstrømsleverandøren er midlertidig utilgjengelig.

API-dokumentasjon

Kom i gang

Konto

Modeller

Genereringer

Bibliotek

Webhooks

Logger

Hastighetsgrenser

Feil

Start gratis

Lag

Musikkstiler

Stemninger

Instrumenter

Bakgrunnsmusikk

Sammenlign

AI-modeller

Lydeffekter

AI-modeller

Selskap