Entwickler
API-Dokumentation
Alles, was du zum Entwickeln mit der MeloLab API brauchst: Authentifizierung, Credits, Generierung, Jobs, Webhooks und Bibliothekssuche.
Erste Schritte
Authentifiziere jede Anfrage mit deinem API-Schlüssel über den Header Authorization: Bearer. Die Basis-URL ist https://melolab.ai. Lese-Endpunkte verbrauchen keine Credits; das Erstellen einer Generierung nutzt deine vorhandenen MeloLab-Credits mit denselben Kosten- und Erstattungsregeln wie die Web-App. Sende beim Erstellen einer Generierung einen Idempotency-Key-Header, damit Wiederholungen sicher sind. Erfolgreiche Antworten sind in ein data-Objekt verpackt; Fehler geben code, message und request_id zurück.
Konto
Lies dein API-Profil, dein Credit-Guthaben und die jüngste Nutzung.
Gibt das authentifizierte API-Profil zurück, inklusive Konto-Stufe und API-Verfügbarkeit.
curl -X GET https://melolab.ai/api/v1/me \
-H "Authorization: Bearer $MELOLAB_API_KEY"Gibt dein vorhandenes MeloLab-Credit-Guthaben zurück. Verbraucht keine Credits.
curl -X GET https://melolab.ai/api/v1/credits \
-H "Authorization: Bearer $MELOLAB_API_KEY"Gibt eine Nutzungsübersicht und aktuelle, anonymisierte Anfrage-Ereignisse zurück.
curl -X GET https://melolab.ai/api/v1/usage \
-H "Authorization: Bearer $MELOLAB_API_KEY"Modelle
Liste verfügbare MeloLab-Modelle und ihre Credit-Kosten auf.
Listet verfügbare MeloLab-Modelle mit ihren Credit-Kosten auf.
curl -X GET https://melolab.ai/api/v1/models \
-H "Authorization: Bearer $MELOLAB_API_KEY"Gibt ein Modell anhand der id zurück.
curl -X GET https://melolab.ai/api/v1/models/suno/v5-5 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Generierungen
Erstelle eine Musikgenerierung, liste aktuelle Generierungen auf und frage einen Job ab, bis er fertig ist.
Erstellt eine asynchrone Musikgenerierung. Nutzt deine vorhandenen MeloLab-Credits; erfordert einen 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"}'Listet deine aktuellen Generierungs-Jobs auf.
curl -X GET https://melolab.ai/api/v1/generations \
-H "Authorization: Bearer $MELOLAB_API_KEY"Fragt eine Generierung ab und gibt nach Abschluss ihre Titel zurück.
curl -X GET https://melolab.ai/api/v1/generations/gen_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Fragt einen asynchronen Job (Musik, Stem-Trennung oder Vocal-Entfernung) ab und gibt die Ausgaben zurück, sobald der Anbieter fertig ist.
curl -X GET https://melolab.ai/api/v1/jobs/job_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Bibliothek
Durchsuche abspielbare Titel und Playlists und lies Details einzelner Titel oder Playlists.
Durchsucht abspielbare Titel und Playlists, einschließlich deiner eigenen privaten Inhalte.
curl -X GET https://melolab.ai/api/v1/library/search?q=lofi \
-H "Authorization: Bearer $MELOLAB_API_KEY"Gibt abspielbare Metadaten eines Titels zurück.
curl -X GET https://melolab.ai/api/v1/tracks/track_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Listet die dir verfügbaren Playlists auf.
curl -X GET https://melolab.ai/api/v1/playlists \
-H "Authorization: Bearer $MELOLAB_API_KEY"Gibt eine Playlist und ihre Titel zurück.
curl -X GET https://melolab.ai/api/v1/playlists/playlist_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Webhooks
Registriere HTTPS-Endpunkte, um benachrichtigt zu werden, wenn asynchrone Jobs abgeschlossen sind – so musst du nicht abfragen. Das vollständige Signing-Secret wird nur einmal beim Erstellen eines Endpunkts angezeigt.
Listet deine aktiven Webhook-Endpunkte auf.
curl -X GET https://melolab.ai/api/v1/webhook-endpoints \
-H "Authorization: Bearer $MELOLAB_API_KEY"Registriert einen öffentlichen HTTPS-Webhook-Endpunkt. Das Signing-Secret wird nur einmal zurückgegeben.
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"}'Aktualisiert die URL oder den Status eines Webhook-Endpunkts.
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"}'Löscht einen Webhook-Endpunkt.
curl -X DELETE https://melolab.ai/api/v1/webhook-endpoints/wh_123 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Protokolle
Sieh dir die API-Anfrageprotokolle der letzten 30 Tage an.
Listet die API-Anfrageprotokolle der letzten 30 Tage auf.
curl -X GET https://melolab.ai/api/v1/logs?limit=20 \
-H "Authorization: Bearer $MELOLAB_API_KEY"Ratenlimits
Lese-Endpunkte erlauben 600 Anfragen pro Minute (50.000 pro Tag). Musikgenerierung erlaubt 12 Anfragen pro Minute (500 pro Tag). Authentifizierung ist auf 120 Anfragen pro Minute je IP begrenzt. Bei Überschreitung wird 429 rate_limited zurückgegeben.
Fehler
Fehler geben einen HTTP-Status plus einen JSON-Body { error: { code, message, request_id } } zurück. Gib request_id an, wenn du den Support kontaktierst.
| Status | Code | Bedeutung |
|---|---|---|
| 401 | authentication_required | Im Authorization-Header wurde kein API-Schlüssel übergeben. |
| 401 | invalid_api_key | Der API-Schlüssel ist ungültig oder widerrufen. |
| 403 | insufficient_scope | Dem API-Schlüssel fehlt ein erforderlicher Geltungsbereich. |
| 400 | invalid_request | Der Anfrage-Body oder die Parameter sind ungültig. |
| 400 | invalid_model | Die angeforderte Modell-id existiert nicht. |
| 402 | insufficient_credits | Nicht genug MeloLab-Credits, um diese Generierung zu erstellen. |
| 409 | idempotency_conflict | Der Idempotency-Key wurde mit einem anderen Anfrage-Body wiederverwendet. |
| 404 | not_found | Die angeforderte Ressource wurde nicht gefunden oder gehört nicht dir. |
| 429 | rate_limited | Zu viele Anfragen; bitte langsamer und später erneut versuchen. |
| 502 | provider_unavailable | Der vorgelagerte Anbieter ist vorübergehend nicht verfügbar. |
