Ontwikkelaars
API-documentatie
Alles wat je nodig hebt om met de MeloLab API te bouwen: authenticatie, credits, generatie, jobs, webhooks en bibliotheekzoekopdrachten.
Aan de slag
Authenticeer elk verzoek met je API-sleutel via de header Authorization: Bearer. De basis-URL is https://melolab.ai. Lees-endpoints verbruiken geen credits; het maken van een generatie gebruikt je bestaande MeloLab-credits met dezelfde kosten- en terugbetalingsregels als de web-app. Stuur een Idempotency-Key-header bij het maken van een generatie zodat nieuwe pogingen veilig zijn. Geslaagde antwoorden zitten in een data-object; fouten geven code, message en request_id terug.
Account
Lees je API-profiel, creditsaldo en recent gebruik.
Geeft het geauthenticeerde API-profiel terug, inclusief accountniveau en API-beschikbaarheid.
curl -X GET https://melolab.ai/api/v1/me \
-H "Authorization: Bearer $MELOLAB_API_KEY"Geeft je bestaande MeloLab-creditsaldo terug. Verbruikt geen credits.
curl -X GET https://melolab.ai/api/v1/credits \
-H "Authorization: Bearer $MELOLAB_API_KEY"Geeft een gebruiksoverzicht en recente, geanonimiseerde verzoekgebeurtenissen terug.
curl -X GET https://melolab.ai/api/v1/usage \
-H "Authorization: Bearer $MELOLAB_API_KEY"Modellen
Toon beschikbare MeloLab-modellen en hun creditkosten.
Toont beschikbare MeloLab-modellen met hun creditkosten.
curl -X GET https://melolab.ai/api/v1/models \
-H "Authorization: Bearer $MELOLAB_API_KEY"Geeft één model terug op id.
curl -X GET https://melolab.ai/api/v1/models/suno/v5-5 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Generaties
Maak een muziekgeneratie, toon recente generaties en poll een job tot deze klaar is.
Maakt een asynchrone muziekgeneratie. Gebruikt je bestaande MeloLab-credits; vereist een 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"}'Toont je recente generatie-jobs.
curl -X GET https://melolab.ai/api/v1/generations \
-H "Authorization: Bearer $MELOLAB_API_KEY"Pollt een generatie en geeft de tracks terug zodra deze klaar is.
curl -X GET https://melolab.ai/api/v1/generations/gen_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Pollt een asynchrone job (muziek, stem-splitsing of vocal-verwijdering) en geeft de output terug zodra de provider klaar is.
curl -X GET https://melolab.ai/api/v1/jobs/job_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Bibliotheek
Zoek afspeelbare tracks en afspeellijsten en lees details van afzonderlijke tracks of afspeellijsten.
Zoekt afspeelbare tracks en afspeellijsten, inclusief je eigen privé-items.
curl -X GET https://melolab.ai/api/v1/library/search?q=lofi \
-H "Authorization: Bearer $MELOLAB_API_KEY"Geeft afspeelbare metadata van een track terug.
curl -X GET https://melolab.ai/api/v1/tracks/track_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Toont de afspeellijsten die voor jou beschikbaar zijn.
curl -X GET https://melolab.ai/api/v1/playlists \
-H "Authorization: Bearer $MELOLAB_API_KEY"Geeft een afspeellijst en de tracks terug.
curl -X GET https://melolab.ai/api/v1/playlists/playlist_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Webhooks
Registreer HTTPS-endpoints om een melding te krijgen wanneer asynchrone jobs klaar zijn, zodat je niet hoeft te pollen. Het volledige signing secret wordt maar één keer getoond bij het maken van een endpoint.
Toont je actieve webhook-endpoints.
curl -X GET https://melolab.ai/api/v1/webhook-endpoints \
-H "Authorization: Bearer $MELOLAB_API_KEY"Registreert een openbaar HTTPS-webhook-endpoint. Het signing secret wordt maar één keer teruggegeven.
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"}'Werkt de URL of status van een webhook-endpoint bij.
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"}'Verwijdert een webhook-endpoint.
curl -X DELETE https://melolab.ai/api/v1/webhook-endpoints/wh_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Logboeken
Bekijk de API-verzoeklogboeken van de afgelopen 30 dagen.
Toont de API-verzoeklogboeken van de afgelopen 30 dagen.
curl -X GET https://melolab.ai/api/v1/logs?limit=20 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Snelheidslimieten
Lees-endpoints staan 600 verzoeken per minuut toe (50.000 per dag). Muziekgeneratie staat 12 verzoeken per minuut toe (500 per dag). Authenticatie is beperkt tot 120 verzoeken per minuut per IP. Bij overschrijding wordt 429 rate_limited geretourneerd.
Fouten
Fouten retourneren een HTTP-status plus een JSON-body { error: { code, message, request_id } }. Vermeld request_id wanneer je contact opneemt met support.
| Status | Code | Betekenis |
|---|---|---|
| 401 | authentication_required | Er is geen API-sleutel opgegeven in de Authorization-header. |
| 401 | invalid_api_key | De API-sleutel is ongeldig of ingetrokken. |
| 403 | insufficient_scope | De API-sleutel mist een vereiste scope. |
| 400 | invalid_request | De aanvraagbody of parameters zijn ongeldig. |
| 400 | invalid_model | De opgevraagde model-id bestaat niet. |
| 402 | insufficient_credits | Niet genoeg MeloLab-credits om deze generatie te maken. |
| 409 | idempotency_conflict | De Idempotency-Key is hergebruikt met een andere aanvraagbody. |
| 404 | not_found | De opgevraagde bron is niet gevonden of is niet van jou. |
| 429 | rate_limited | Te veel verzoeken; vertraag en probeer later opnieuw. |
| 502 | provider_unavailable | De upstream-provider is tijdelijk niet beschikbaar. |
