Dokumentation

Mubert KI-Musik-API

Version 3.0

Inhaltsverzeichnis

Install Skill

Authentifizierung

Lizenz

Benutzerregistrierung

Track-Generierung

Track-Shop

Mubert Musikbibliothek

Titel

Selbstbewusstsein

Willkommen bei der Mubert AI Music API v3!

Diese API ermöglicht die Integration von Funktionen zur Track-Generierung und zum Musik-Streaming in Apps, Spielen oder Diensten. Um die API zu verwenden, fordern Sie bitte Ihre API-Schlüssel beim Mubert-Team an (via [email protected]).

Die REST-API kommuniziert ausschließlich in JSON über SSL (HTTPS). Alle Endpunkt-URLs beginnen mit https://music-api.mubert.com/api/v3/ (außer Streaming-URLs, sie beginnen mit https://stream.mubert.com/b2b/v3/)

Parameter müssen in JSON serialisiert und im Anforderungskörper übergeben werden.
Sie sollten die Medientyp-Angabe von application/json verwenden.

Es gibt zwei Hauptverzeichnisse in der API:

Dienst — https://music-api.mubert.com/api/v3/service/ — wird vom Unternehmen verwendet, um Lizenzen und Kunden zu verwalten.
öffentlich — https://music-api.mubert.com/api/v3/public/ — wird von Kunden verwendet, um Streaming-Funktionen und Titel zu erhalten.

Install Mubert Skill

Github: https://github.com/MubertAI/skills

npx skills add MubertAI/skills

Authentifizierung

Die REST-API unterstützt eine auf API-Schlüsseln basierende Authentifizierung.

Für Unternehmen

curl -X POST "https://music-api.mubert.com/api/v3/service/*" \
-H "Content-Type: application/json" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Für Kunden

curl -X POST \"https://music-api.mubert.com/api/v3/public/*\" \\\n-H \"Content-Type: application/json\" \\\n-H \"customer-id: CUSTOMER_ID\" \\\n-H \"access-token: ACCESS_TOKEN\" \\

Für das Service-Verzeichnis verwenden Sie ein Paar aus COMPANY_ID und LICENSE_TOKEN und für das öffentliche Verzeichnis ein Paar aus CUSTOMER_ID und ACCESS_TOKEN.

Sie müssen COMPANY_ID / LICENSE_TOKEN / CUSTOMER_ID / CUSTOMER_TOKEN mit Ihren tatsächlichen Tokens ersetzen.

Lizenz

Zu Ihrer Bequemlichkeit haben wir es so eingerichtet, dass ein Unternehmen mehrere Lizenzen mit jeweils eigenen Funktionen und Limits haben kann. So können Sie Benutzer verschiedenen Lizenzen zuordnen. Standardmäßig hat das Unternehmen eine Lizenz, und in den meisten Fällen reicht das aus.

Sie können Informationen zu Ihren Lizenzen und Limits erhalten.

Verwenden Sie Modell-Lizenzen mit der GET-Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/service/licenses" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Sie können auch Informationen zu einer bestimmten Lizenz erhalten

curl -X GET "https://music-api.mubert.com/api/v3/service/licenses/LICENSE_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Antwort

200 OK

{
    "data": {
        "id": "9e113460-1125-4c09-83c0-94a3b36b0bf3",
        "company_id": "9e1133df-0ac2-4824-bb1a-827fb0698380",
        "type": "kostenpflichtig",
        "status": "aktiv",
        "webhook_url": "https://b2b3-webhook.mubert.com/",
        "webhook_enabled": true,
        "track_expiration_time": 900,
        "allow_all_features": true,
        "features": [
            "Track",
            "ttm",
            "itm",
            "Streaming"
        ],
        "allow_all_bitrates": true,
        "bitrates": [
            32,
            96,
            128,
            192,
            256,
            320
        ],
        "default_bitrate": 128,
        "allow_all_intensities": true,
        "intensities": [
            "niedrig",
            "mittel",
            "hoch"
        ],
        "default_intensity": "hoch",
        "allow_all_formats": true,
        "track_formats": [
            "mp3",
            "wav"
        ],
        "default_format": "mp3",
        "allow_all_modes": true,
        "track_modes": [
            "Track",
            "Jingle",
            "Loop",
            "Mix"
        ],
        "default_mode": "Track",
        "expired_at": "2025-02-01T00:00:00.000000Z",
        "license_limits": {
            "id": "9e113460-140f-409d-a5e8-c755bd6cf7f2",
            "license_id": "9e113460-1125-4c09-83c0-94a3b36b0bf3",
            "max_track_duration": 1500,
            "max_concurrent_track_generations": -1,
            "total_tracks_count": 5,
            "total_tracks_count_limit": -1,
            "total_tracks_duration": 306,
            "total_tracks_duration_limit": -1,
            "monthly_tracks_count": 5,
            "monthly_tracks_count_limit": -1,
            "monthly_tracks_duration": 306,
            "monthly_tracks_duration_limit": -1,
            "daily_tracks_count": 0,
            "daily_tracks_count_limit": -1,
            "daily_tracks_duration": 0,
            "daily_tracks_duration_limit": -1,
            "total_streaming_duration": 70,
            "total_streaming_duration_limit": -1,
            "monthly_streaming_duration": 70,
            "monthly_streaming_duration_limit": -1,
            "daily_streaming_duration": 0,
            "daily_streaming_duration_limit": -1,
            "customers_count": 2,
            "customers_count_limit": 5,
            "customer_max_concurrent_track_generations": -1,
            "customer_total_tracks_count_limit": -1,
            "customer_total_tracks_duration_limit": -1,
            "customer_monthly_tracks_count_limit": -1,
            "customer_monthly_tracks_duration_limit": -1,
            "customer_daily_tracks_count_limit": 5,
            "customer_daily_tracks_duration_limit": -1,
            "customer_total_streaming_duration_limit": -1,
            "customer_monthly_streaming_duration_limit": 0,
            "customer_daily_streaming_duration_limit": -1,
            "daily_reset_at": "2025-01-01T00:00:00.000000Z",
            "monthly_reset_at": "2025-01-01T00:00:00.000000Z"
        }
    }
}

Dies ist das Lizenzmodell. Hier finden Sie Lizenzfunktionen, Standardparameter, Limits und Statistiken.

Sie können -1 in einigen Grenzwerten bemerken; das bedeutet, dass ein Limit nicht gesetzt ist (unbegrenzt).

Webhooks

In dieser Version der API können Sie der Lizenz einen Webhook hinzufügen, über den Sie Benachrichtigungen über den Status des Track-Generierungsprozesses erhalten.

Verwenden Sie die PUT-Methode, um einen Webhook festzulegen

curl -L -X PUT "https://music-api.mubert.com/api/v3/service/licenses/LICENSE_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"webhook_url\": \"https://YOUR_WEBHOOK_URL\",
    \"webhook_enabled\": true
}"

Sie erhalten das aktualisierte Lizenzmodell.

Nachdem Sie den Webhook hinzugefügt haben, erhalten Sie Nachrichten mit Track-Modellen. Zum Beispiel so:

{
    "id": "TRACK_ID",
    "session_id": "SESSION_ID",
    "parent_session_id": null,
    "playlist_index": "1.0.0",
    "prompt": null,
    "duration": 61,
    "intensity": "hoch",
    "mode": "track",
    "key": "A#",
    "bpm": 120,
    "generations": [
    {
        "session_id": "GENERATION_SESSION_ID",
        "format": "mp3",
        "bitrate": 128,
        "status": "fertig",
        "generated_at": "2025-01-01T00:00:00.000000Z",
        "expired_at": "2025-01-02T00:00:00.000000Z",
        "created_at": "2025-01-01T00:00:00.000000Z",
        "url": "YOUR_TRACK_LINK"
    }]
}

Mehr über das Track-Modell erfahren Sie im Abschnitt Spurenerzeugung.

Benutzerregistrierung

Jeder Endbenutzer Ihres Produkts (Dienstes) wird durch ein eindeutiges Token-Paar identifiziert: customer-id und access-token. Diese Tokens sind erforderlich, um auf die Inhalte und Funktionen zuzugreifen.

Gewinnen Sie so viele Kunden, wie es Nutzer gibt, die mit Musik versorgt werden sollen.

Um es zu erstellen, verwenden Sie das Modell customers mit dem unten beschriebenen POST-Request.

curl -X POST "https://music-api.mubert.com/api/v3/service/customers" \
-H "Content-Type: application/json" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN" \
-d "{
    \"custom_id\": \"YOUR_CUSTOM_ID\"
}"

Eingabeparameter

custom_id — Ihre interne eindeutige Kunden-ID, die aus lateinischen Buchstaben, Zahlen und zulässigen Sonderzeichen bestehen kann: ".", "_", "@", "-"' und nicht länger als 255 Zeichen sein sollte.
company-id and license-token — vom Mubert-Team bereitgestellt

Antwortet bei Erfolg mit einer 200-OK-Antwort und einer JSON-Antwort.

Es gibt Kundenmodell

{
    "data": {
        "id": "CUSTOMER_ID",
        "company_id": "COMPANY_ID",
        "custom_id": "IHRE_CUSTOM_ID",
        "status": "aktiv",
        "access": {
            "id": "ACCESS_ID",
            "customer_id": "CUSTOMER_ID",
            "license_id": "LICENSE_ID",
            "token": "ACCESS_TOKEN",
            "expired_at": "2025-02-01T00:00:00.000000Z",
            "customer_limits": {
                "id": "CUSTOMER_LIMITS_ID",
                "customer_id": "CUSTOMER_ID",
                "license_id": "LICENSE_ID",
                "max_concurrent_track_generations": -1,
                "total_tracks_count": 0,
                "total_tracks_count_limit": -1,
                "total_tracks_duration": 0,
                "total_tracks_duration_limit": -1,
                "monthly_tracks_count": 0,
                "monthly_tracks_count_limit": -1,
                "monthly_tracks_duration": 0,
                "monthly_tracks_duration_limit": -1,
                "daily_tracks_count": 0,
                "daily_tracks_count_limit": 5,
                "daily_tracks_duration": 0,
                "daily_tracks_duration_limit": -1,
                "total_streaming_duration": 0,
                "total_streaming_duration_limit": -1,
                "monthly_streaming_duration": 0,
                "monthly_streaming_duration_limit": -1,
                "daily_streaming_duration": 0,
                "daily_streaming_duration_limit": -1,
                "daily_reset_at": null,
                "monthly_reset_at": null
            }
        }
    }
}

Hier:

Kunden-ID = data->access->customer_id (CUSTOMER_ID)
Zugriffstoken = data->access->access_token (ACCESS_TOKEN)
daily_reset_at, monthly_reset_at — nullfähiges Datum

Außerdem können Sie persönliche Kundenlimits und Statistiken einsehen.

Benutzerverwaltung

Benutzerinformationen

Sie können mit Paginierung Informationen zu all Ihren Benutzern abrufen.

Verwende die GET-Anfrage mit dem Modell customers

curl -X GET "https://music-api.mubert.com/api/v3/service/customers" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Die Antwort enthält eine Liste von Kundenmodellen.

Verwenden Sie die Seitennummerierung, um alle Daten zu sehen.

curl -L -X GET "https://music-api.mubert.com/api/v3/service/customers?limit=10&offset=2" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Sie können auch Informationen über einen bestimmten Kunden mithilfe seiner benutzerdefinierten Kennung oder Kunden-ID abrufen. Zum Beispiel:

curl -X GET "https://music-api.mubert.com/api/v3/service/customers/CUSTOMER_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Oder

curl -X GET "https://music-api.mubert.com/api/v3/service/customers/custom-id/YOUR_CUSTOM_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Die Antworten enthalten auch das Kundenmodell.

Benutzer löschen

Verwenden Sie die DELETE-Anfrage mit dem Modell customers

curl -X DELETE "https://music-api.mubert.com/api/v3/service/customers/CUSTOMER_ID" \
-H "company-id: COMPANY_ID" \
-H "license-token: LICENSE_TOKEN"

Antwortet bei Erfolg mit einer 204 No Content-Antwort.

Liste der Kanäle

Benutzerinformationen

Sowohl das Streaming als auch die Titelgenerierung erfordern, dass Sie einen Musikkanal auswählen.

Verwenden Sie GET im Modell playlists, um eine Liste aller verfügbaren Kategorien, Gruppen, Kanäle und ihrer Playlist-Indizes zu erhalten.

curl -X GET "https://music-api.mubert.com/api/v3/public/playlists" \ 
-H "customer-id: CUSTOMER_ID" \ 
-H "access-token: ACCESS_TOKEN"

Antwort 200 OK

{
    "data": [
        {
            "playlist_index": "3.0.0",
            "category": "Ruhe",
            "group": "Ambient",
            "channel": "Meditation",
            "params": [
                {
                    "bpm": {
                        "gt": 45,
                        "lt": 83
                    },
                    "keys": [
                        "Cm",
                        "C",
                        "C#m",
                        "C#",
                        "Dm",
                        "D",
                        "D#m",
                        "D#",
                        "Em",
                        "E",
                        "Fm",
                        "F",
                        "F#m",
                        "F#",
                        "Gm",
                        "G",
                        "G#m",
                        "G#",
                        "Am",
                        "A",
                        "A#m",
                        "A#",
                        "Bm",
                        "B"
                    ]
                }
            ]
        },
        {
            "playlist_index": "3.0.1",
            "category": "Ruhe",
            "group": "Ambient",
            "channel": "Om",
            "params": [...]
        },
        {
            "playlist_index": "3.0.2",
            "category": "Ruhe",
            "group": "Ambient",
            "channel": "Zen",
            "params": [...]
        },
        .
        .
        .
}

Hier können Sie auch den BPM-Bereich und die Tonartenliste sehen. Diese Werte stehen für die Track-Erstellung zur Verfügung.

Bitte beachten Sie, dass der bpm-Parameter einen verfügbaren Bereich hat, innerhalb dessen Sie in einer bestimmten Kategorie generieren können.

gt bedeutet größer als, lt bedeutet kleiner als.

Musikstreaming

Bevor Sie die Streaming-Funktion verwenden, stellen Sie sicher, dass sie im Rahmen der Vertragsvereinbarung aktiviert ist. Außerdem finden Sie sie in Ihren Lizenzinformationen. Um einen Link zum Streaming zu erhalten, verwenden Sie die folgende Anfrage

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/streaming/get-link" \
-H "Content-Type: application/json" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-d "{
  \"playlist_index\": \"1.0.0\",
  \"bitrate\": 320,
  \"intensity\": \"medium\",
  \"type\": \"http\"
}"

Antwort 200 OK

{
    "data": {
        "link": "https://stream.mubert.com/b2b/v3?customer_id=CUSTOMER_ID&access_token=ACCESS_TOKEN&playlist=1.0.0&bitrate=320&intensity=medium"
    }
}

Parameter

playlist_index (erforderlich) — Kanalindex
bitrate (optional) — Tonqualität gemessen in kbps
intensity (optional) — die Komplexität des Arrangements, es spielen gleichzeitig weniger oder mehr Instrumente
type (optional) — Streaming-Protokolltyp

Mögliche Werte für bitrate : 32, 96, 128, 192, 256, 320

Mögliche Werte für intensity : low, medium, high

Mögliche Werte für type : http, webrtc

Wenn optionale Parameter weggelassen werden oder falsche Werte enthalten, werden Standardparameter mit bitrate=128, intensity=high und type=http angewendet.

gt bedeutet größer als, lt bedeutet kleiner als.

Wiederholungsmodus

Verwenden Sie die set-loop-state-URL, um den letzten Teil der Musikkomposition zu wiederholen (oder den Loop-Modus auszuschalten).

Parameter

loop (verpflichtend) — mögliche Werte: off, on
time (optional) — auf die aktuelle Wiedergabezeit des Streams in Sekunden (seit Sitzungsbeginn) setzen, um die Benutzererfahrung zu verbessern

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-loop-state" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"loop\": \"on\",
  \"time\": 0
}"

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Intensität

Die set-intensity-URL ermöglicht das Ändern der Komplexität des Arrangements. Verschiedene Presets bestehen aus weniger oder mehr Instrumenten, die gleichzeitig spielen. Die Intensitäten wechseln nahtlos, ohne den Stream zu unterbrechen.

Mögliche Werte für Intensität : low, medium, high

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-intensity" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"intensity\": \"medium\"
}"

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Generation neu starten

Um den Stream neu zu starten, sodass ein anderer Titel (Melodie) mit derselben url abgespielt wird, verwenden Sie die POST-Methode mit streaming/restart.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/restart" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Track-Generierung

Bevor Sie die Track-Erstellungsfunktion verwenden, stellen Sie sicher, dass sie unter der Vertragsvereinbarung aktiviert ist. Außerdem finden Sie sie in Ihren Lizenzinformationen.

Mit dieser API können Sie auf Anfrage benutzerdefinierte Tracks erstellen. Jeder Track ist eine exklusive Musikkomposition, die Ihnen über einen speziellen Link zum Download zur Verfügung steht.

Um mit Tracks zu interagieren, verwenden Sie das Modell tracks.

Track erstellen

Verwenden Sie POST, um einen Track mit den ausgewählten Eigenschaften zu erstellen.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"playlist_index\": \"1.0.0\",
    \"duration\": 60,
    \"bitrate\": 128,
    \"format\": \"wav\",
    \"intensity\": \"high\",
    \"mode\": \"track\"
}"

Parameter

playlist_index (obligatorisch) - Kanalindex
duration (obligatorisch) - Titellänge in Sekunden
format (optional) - mp3 oder wav
bitrate (optional) - Klangqualität gemessen in kbps
intensity (optional) - Komplexität des Arrangements, es spielen gleichzeitig weniger oder mehr Instrumente
mode (optional) — Kompositionstyp (track, loop, jingle, mix)

Mögliche Werte für bitrate : 32, 96, 128, 192, 256, 320

Mögliche Werte für intensity : low, medium, high

Wenn optionale Parameter weggelassen werden oder falsche Werte enthalten, werden Standardparameter mit format=mp3, bitrate=128, intensity=high, mode=track angewendet

track - bezeichnet einen Titel mit gemeinsamer Struktur aus Intro, Drops, Breaks und Outro

loop - steht für einen Titel, der in einer Schleife wiedergegeben werden kann

jingle - eignet sich am besten für Musikinhalte mit einer Länge von bis zu 40 Sekunden – das sind kurze, abgeschlossene Titel mit fester und logischer Struktur

mix - ahmt die Arbeit eines DJs nach: Titel folgen nacheinander und gehen harmonisch ineinander über

playlist_index ist ein universeller Kanalindex im Format „0.0.0“, der aus category_id.group_id.channel_id besteht. Lassen Sie die letzten Ziffern weg, um mehrere Kanäle zusammenzuführen.

Zum Beispiel: playlist=0.0 spielt alle Kanäle innerhalb der Gruppe „Calm“ ab; playlist=0 spielt die gesamte Kategorie „Moods“ ab.

Antwort

{
    "data": {
        "id": "TRACK_ID",
        "session_id": "SESSION_ID",
        "playlist_index": "1.0.0",
        "prompt": null,
        "bitrate": 128,
        "duration": 61,
        "intensity": "hoch",
        "mode": "track",
        "key": null,
        "bpm": null,
        "generations": [
            {
                "session_id": "GENERATION_SESSION_ID",
                "format": "mp3",
                "bitrate": 128,
                "status": "wird verarbeitet",
                "generated_at": null,
                "expired_at": null,
                "created_at": "2025-01-01T00:00:00.000000Z",
                "url": null
            }
        ]
    }
}

Hier:

prompt, key, bpm, url — nullierbarer String
generated_at, expired_at — nullierbares Datum

Um zu prüfen, ob ein Track erstellt wurde, verwenden Sie das tracks-Modell mit TRACK_ID. So geht's:

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Oder fügen Sie Ihrer Lizenz einen Webhook hinzu und erhalten Sie Nachrichten, wenn der Vorgang abgeschlossen ist.

Text-zu-Musik

Sie können mit einem Text-Prompt und einer Reihe ausgewählter Merkmale einen Track erstellen. Diese Methode ähnelt der vorherigen, aber statt einen Kanal auszuwählen, senden Sie uns eine Textnachricht. Sie wird an das Transformer-Neuronale Netzwerk mit einer Tag-Datenbank übermittelt, und die passenden Klangsets werden automatisch ausgewählt. Danach erstellt unsere Composer-Engine einen Track und sendet Ihnen die Datei zurück.

Bevor Sie es verwenden, stellen Sie sicher, dass es gemäß der Vertragsvereinbarung aktiviert ist.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"prompt\": \"YOUR_TEXT_PROMPT\",
    \"duration\": 60,
    \"bitrate\": 128,
    \"mode\": \"track\",
    \"intensity\": \"medium\",
    \"format\": \"mp3\"
}"

Parameter

prompt (Pflichtfeld) —dein Text-Prompt auf Englisch, maximal 200 Zeichen
duration (Pflichtfeld) — Trackdauer in Sekunden
format (optional) — mp3 oder wav
bitrate (optional) — Klangqualität gemessen in kbps
intensity (optional) — Komplexität des Arrangements, es spielen gleichzeitig weniger oder mehr Instrumente
mode (optional) — Kompositionstyp (track, loop)

Mögliche Werte für bitrate : 32, 96, 128, 192, 256, 320

Mögliche Werte für intensity : low, medium, high

prompt — Textaufforderung, die Sie von Ihrer Benutzereingabe oder von anderen verbundenen Eingaben (Sprachmodelle, Bild-zu-Text, Spielmechaniken usw.) erhalten können

track — bedeutet einen Track mit gemeinsamer Struktur aus Intro, Drops, Breaks und Outro

loop — steht für einen Track, der geloopt werden kann

Wenn optionale Parameter weggelassen werden oder falsche Werte enthalten, werden Standardparameter mit format=mp3, bitrate=128 , intensity=high, mode=track angewendet

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Intensität

Mögliche Werte für Intensität : low, medium, high

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/set-intensity" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
  \"intensity\": \"medium\"
}"

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Generation neu starten

Um den Stream neu zu starten, sodass ein anderer Titel (Melodie) mit derselben url abgespielt wird, verwenden Sie die POST-Methode mit streaming/restart.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/streaming/restart" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

Antwortet mit 204 Kein Inhalt, wenn erfolgreich.

Bild-zu-Musik

Sie können einen Track mit einem Bild erstellen. Bevor Sie ihn verwenden, stellen Sie sicher, dass er im Rahmen der Vertragsvereinbarung aktiviert ist.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-F "image=@\"/filepath\"" \
-F "duration=\"60\"" \
-F "bitrate=\"128\"" \
-F "mode=\"track\"" \
-F "intensity=\"medium\"" \
-F "format=\"mp3\""

Parameter

image (erforderlich) — Ihr Bild im JPEG/PNG-Format, maximal 10 MB
duration (erforderlich) — Titeldauer in Sekunden
format (optional) — mp3 oder wav
bitrate (optional) — Klangqualität gemessen in kbps
intensity (optional) — Komplexität des Arrangements, es spielen gleichzeitig weniger oder mehr Instrumente
mode (optional) — Kompositionstyp (track, loop)

Mögliche Werte für bitrate : 32, 96, 128, 192, 256, 320

Mögliche Werte für intensity : low, medium, high

track — bedeutet einen Titel mit einer gemeinsamen Struktur mit Intro, Drops, Breaks und Outro

loop — steht für einen Titel, der geloopt werden kann

Wenn optionale Parameter weggelassen werden oder falsche Werte enthalten, werden Standardparameter mit format=mp3, bitrate=128 , intensity=high, mode=track angewendet

BPM-/Tonart-Generierung

Sie können bpm und Tonart zu den Generierungsparametern von playlist_index hinzufügen.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"playlist_index\": \"6.1.4\",
    \"duration\": 60,
    \"bitrate\": 320,
    \"format\": \"mp3\",
    \"intensity\": \"high\",
    \"mode\": \"track\",
    \"bpm\":112,
    \"key\":\"D\"
}"

Antwort

Gibt bei Erfolg 200 OK mit dem track-Modell zurück.

Spurbearbeitung

Sie können einige Parameter eines vorhandenen Tracks ändern.

Anfrage

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"duration\": 90,
    \"bitrate\": 256,
    \"format\": \"mp3\",
    \"intensity\": \"high\"
}"

Antwort 200 OK

{
    "data": {
        "id": "TRACK_ID",
        "session_id": "SESSION_ID",
        "playlist_index": null,
        "prompt": null,
        "duration": 90,
        "intensity": "high",
        "mode": "track",
        "key": null,
        "bpm": null,
        "generations": [
            {
                "session_id": "GENERATION_SESSION_ID",
                "format": "mp3",
                "bitrate": 256,
                "status": "wird verarbeitet",
                "generated_at": null,
                "expired_at": null,
                "created_at": "2025-01-01T00:00:00.000000Z",
                "url": null
            }
        ]
    }
}

Außerdem können Sie einen Teil der Spur ersetzen. Jede Spur besteht aus Instrumenten. Die Spur kann Instrumente wie die folgenden enthalten:

SCHLAGZEUG, PERCUSSION, HI-HATS, KLATSCHER, BASS, MITTEN, LEADS, FX, GESANG, FLÄCHEN, RISER, IMPACT

Diese Instrumente können zu Stems wie

Also enthalten diese Stems die folgenden Instrumente:

DRUMS enthält DRUMS, PERCS, HATS, CLAPS
BASS enthält BASS
LEADS enthält MIDS, LEADS, PADS
VOCALS enthält VOCALS
FX enthält FX, RISER, IMPACT

Sie können sowohl das Instrument als auch den Stiel ersetzen. Instrument(e) ersetzen:

Instrument(e) ersetzen:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"replace_instruments\":[\"HATS\"]
}"

Stiele ersetzen:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"replace_stems\":[\"DRUMS\"]
}"

Instrument(e) löschen:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"delete_instruments\":[\"PADS\", \"PERCS\"]
}"

Stängel löschen:

curl -X POST "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID/edit" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{
    \"delete_stems\":[\"BASS\", \"FX\"]
}"

Alle diese Anfragen erhalten das Track-Modell.

Titelliste

Um die Track-Liste zu erhalten, verwenden Sie GET mit dem Modell tracks.

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Die Antwort enthält eine Liste von Streckenmodellen.

Verwenden Sie die Seitennavigation, um alle Daten anzuzeigen.

Sie können auch Informationen zu einem bestimmten Titel erhalten.

curl -X GET "https://music-api.mubert.com/api/v3/public/tracks/TRACK_ID" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Die Antwort enthält ein Streckenmodell.

Track-Shop

Die Track-Store-Funktion ermöglicht es Ihnen, einen Puffer mit vorab generierten Tracks zu erstellen. Sie eignet sich hervorragend, wenn Sie einen einzigartigen Track mit der genauen Dauer, dem Modus und dem Format erhalten möchten, ohne lange warten zu müssen. Wir erstellen einen Cloud-Bucket und richten einen dedizierten Generator ein, um den Prozess des Empfangens von Dateien zu beschleunigen. Mubert erstellt eine Reihe von Tracks mit einem Parametersatz und legt sie in den Bucket. Wenn Sie eine dieser Dateien verwenden, startet eine ähnliche Track-Generierung, um den Puffer zu füllen. Die Anzahl der Dateien im Bucket hängt von der durchschnittlichen Auslastung Ihres Dienstes ab. Um dies zu berechnen, benötigen wir außerdem eine Liste der folgenden Parameter von Ihnen: Modus, Dauer, Bitrate, Intensität, Format. Bitte wählen Sie die Werte dieser Parameter aus und senden Sie eine E-Mail an unseren Manager, um mit der Erstellung des Buckets fortzufahren. Außerdem können Sie Playlists auswählen, die Sie vorab generieren möchten; standardmäßig verwenden wir alle Kanäle.

Sie erhalten automatisch den Track aus dem Track Store, wenn die Anfrageparameter des Tracks mit den Parametern des Stores übereinstimmen. Bevor Sie den Track Store verwenden, stellen Sie bitte sicher, dass er gemäß der Vertragsvereinbarung aktiviert ist.

Mubert Musikbibliothek

Wir haben eine Bibliothek mit mehr als 12.000 Tracks zusammengestellt, die mithilfe von Mubert-Künstlicher Intelligenz erstellt und von unseren Musikredakteuren ausgewählt wurden.

Parameter

Verwenden Sie die GET-Methode, um Statistiken der Musikbibliothek und Parameter anzuzeigen, nach denen Sie Titel filtern können.

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

[
    {
        "param": "activities",
        "values": [
            {
                "value": "Minimal 170",
                "tracks_count": 80
            },
            {
                "value": "Schön",
                "tracks_count": 40
            },
            {
                "value": "Meditation",
                "tracks_count": 108
            },
            .
            .
            .
        ]
    },
    {
        "param": "bpm",
        "values": [
            {
                "value": "100",
                "tracks_count": 684
            },
            {
                "value": "105",
                "tracks_count": 13
            },
            {
                "value": "108",
                "tracks_count": 186
            },
            .
            .
            .
        ]
    },
    .
    .
    .
]

Sie können auch Informationen zu einem bestimmten Parameter erhalten. Zum Beispiel: BPM 120

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params?bpm=120" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

{
        "param": "Themen",
        "values": [
            {
                "value": "Unternehmen",
                "tracks_count": 315
            },
            {
                "value": "Podcast",
                "tracks_count": 12
            },
            .
            .
            .
        ]
    },
    {
        "param": "Genres",
        "values": [
            {
                "value": "Nu Disco",
                "tracks_count": 138
            },
            {
                "value": "Folk",
                "tracks_count": 27
            },
            .
            .
            .
        ]
    },

Dies bedeutet, dass Sie 315 Titel mit BPM 120 im Thema "Сorporate", 12 Titel im Thema "Podcast", 138 Titel im Genre "Nu Disco" und 27 Titel im Genre "Folk" finden können.

Sie können mehrere Parameter angeben und dann wird ein logisches AND auf sie angewendet.

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/params?bpm=120&genres=Nu%20Disco" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

[
    {
        "param": "bpm",
        "values": [
            {
                "value": "120",
                "tracks_count": 138
            }
        ]
    },
    {
        "param": "Genres",
        "values": [
            {
                "value": "Nu Disco",
                "tracks_count": 138
            },
            {
                "value": "EDM",
                "tracks_count": 3
            },
            {
                "value": "Tropical House",
                "tracks_count": 11
            },
            .
            .
            .
        ]
    },
    .
    .
    .
    {
        "param": "Dauer",
        "values": [
            {
                "value": "15",
                "tracks_count": 7
            },
            {
                "value": "60",
                "tracks_count": 18
            },
            {
                "value": "120",
                "tracks_count": 11
            },
            {
                "value": "165",
                "tracks_count": 14
            },
            {
                "value": "180",
                "tracks_count": 64
            },
            {
                "value": "420",
                "tracks_count": 12
            },
            {
                "value": "1500",
                "tracks_count": 12
            }
        ]
    }
]

In der Antwort können Sie auch die Anzahl der Tracks jeder Dauer sehen, die der Anfrage BPM 120 AND Genre Nu Disco entsprechen

Titel

Verwenden Sie die GET-Methode, um die Liste der Tracks zu erhalten.

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/tracks" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

{
    "data": [
        {
            "id": "TRACK_ID",
            "session_id": "SESSION_ID",
            "playlist_index": "0.6.1",
            "prompt": null,
            "duration": 120,
            "intensity": "hoch",
            "mode": "track",
            "bpm": 100,
            "key": "D#m",
            "generations": [
                {
                    "session_id": "GENERATION_SESSION_ID",
                    "format": "mp3",
                    "bitrate": 320,
                    "status": "abgeschlossen",
                    "generated_at": "2025-02-01T00:00:00.000000Z",
                    "created_at": "2025-02-01T00:00:00.000000Z",
                    "url": "YOUR_TRACK_LINK"
                }
            ]
        },
        .
        .
        .
    ],
    "meta": {
        "offset": 0,
        "limit": 100,
        "total": 10075
    }
}

Die Antwort enthält eine Liste von Track-Modellen. Verwenden Sie die Paginierung, um alle Daten anzuzeigen. Sie können auch einen oder mehrere Parameter verwenden, um Tracks zu filtern und die am besten geeigneten zu finden. Zum Beispiel: BPM 120 AND Genre Nu Disco AND Duraton 180

Anfrage

curl -X GET "https://music-api.mubert.com/api/v3/public/music-library/tracks?bpm=120&genres=Nu%20Disco&duration=180" \
-H "customer-id: CUSTOMER_ID" \
-H "access-token: ACCESS_TOKEN"

Antwort

{
    "data": [
        {
            "id": "TRACK_ID",
            "session_id": "SESSION_ID",
            "playlist_index": null,
            "prompt": null,
            "duration": 180,
            "intensity": "hoch",
            "mode": "track",
            "bpm": 120,
            "key": "G",
            "generations": [
                {
                    "session_id": "GENERATION_SESSION_ID",
                    "format": "mp3",
                    "bitrate": 320,
                    "status": "fertig",
                    "generated_at": "2022-02-01T00:08:00.000000Z",
                    "created_at": "2022-02-01T00:00:00.000000Z",
                    "url": "YOUR_TRACK_LINK"
                }
            ]
        },
    ],
     "meta": {
        "offset": 0,
        "limit": 100,
        "total": 64
    }
}

In der Antwort auch Liste der Track-Modelle. Verwenden Sie die Paginierung, um alle Daten zu sehen.

Selbstbewusstsein

Für weitere technische Informationen können Sie swagger verwenden: https://music-api.mubert.com/api/v3/swagger

Preisgestaltung

Transparent und flexibel

Versuchen Sie es für nur 49 $ pro Monat

Testplan

Für CustDev und Tests

49 $

/ Monat

Jetzt anfangen

100 Generationen / Monat

100 Streaming-Minuten / Monat

Enthaltene Funktionen:

100 generierte Tracks

100 Streaming-Minuten

Text-zu-Musik

Bild-zu-Musik

Hohe Qualität

Nicht erstattungsfähig

Monetarisierter Inhalt

Kuratiere Bibliothek

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für kleine Produkte

199 $

/ Monat

Jetzt anfangen

5.000 Generationen / Monat

5.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Testfunktionen

5.000 generierte Tracks

5.000 Streaming-Minuten

12.000+ kuratierte Bibliothek

Webhooks

Verlustfreie Qualität

Monetarisierter Inhalt

Nicht erstattungsfähig

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für große Apps

499 $

/ Monat

Jetzt anfangen

30.000 Generationen / Monat

30.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Startup-Funktionen

30.000 generierte Tracks

30.000 Streaming-Minuten

Nicht erstattungsfähig

Unterlizenzierung

Engagierter Support

Verteilung

Individueller Plan

Für Sonderanfragen texten Sie uns unter [email protected]

Mögliche Funktionen:

Gesang

Benutzerdefinierte Musikstämme

Audio-Branding

Musikpläne

Testplan

Für CustDev und Tests

49 $

/ Monat

Jetzt anfangen

100 Generationen / Monat

100 Streaming-Minuten / Monat

Enthaltene Funktionen:

100 generierte Tracks

100 Streaming-Minuten

Text-zu-Musik

Bild-zu-Musik

Hohe Qualität

Nicht erstattungsfähig

Monetarisierter Inhalt

Kuratiere Bibliothek

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für kleine Produkte

199 $

/ Monat

Jetzt anfangen

5.000 Generationen / Monat

5.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Testfunktionen

5.000 generierte Tracks

5.000 Streaming-Minuten

12.000+ kuratierte Bibliothek

Webhooks

Verlustfreie Qualität

Monetarisierter Inhalt

Nicht erstattungsfähig

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für große Apps

499 $

/ Monat

Jetzt anfangen

30.000 Generationen / Monat

30.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Startup-Funktionen

30.000 generierte Tracks

30.000 Streaming-Minuten

Nicht erstattungsfähig

Unterlizenzierung

Engagierter Support

Verteilung

Individueller Plan

Für Sonderanfragen texten Sie uns unter [email protected]

Mögliche Funktionen:

Gesang

Benutzerdefinierte Musikstämme

Audio-Branding

Musikpläne

Testplan

Für CustDev und Tests

49 $

/ Monat

Jetzt anfangen

100 Generationen / Monat

100 Streaming-Minuten / Monat

Enthaltene Funktionen:

100 generierte Tracks

100 Streaming-Minuten

Text-zu-Musik

Bild-zu-Musik

Hohe Qualität

Nicht erstattungsfähig

Monetarisierter Inhalt

Kuratiere Bibliothek

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für kleine Produkte

199 $

/ Monat

Jetzt anfangen

5.000 Generationen / Monat

5.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Testfunktionen

5.000 generierte Tracks

5.000 Streaming-Minuten

12.000+ kuratierte Bibliothek

Webhooks

Verlustfreie Qualität

Monetarisierter Inhalt

Nicht erstattungsfähig

Unterlizenzierung

Verteilung

Engagierter Support

Startup-Plan

Für große Apps

499 $

/ Monat

Jetzt anfangen

30.000 Generationen / Monat

30.000 Streaming-Minuten / Monat

Enthaltene Funktionen:

Alle Startup-Funktionen

30.000 generierte Tracks

30.000 Streaming-Minuten

Nicht erstattungsfähig

Unterlizenzierung

Engagierter Support

Verteilung

Individueller Plan

Für Sonderanfragen texten Sie uns unter [email protected]

Mögliche Funktionen:

Gesang

Benutzerdefinierte Musikstämme

Audio-Branding

Musikpläne

ist jetzt live — Vertone deine Videos

Generieren Sie Musik in über 200 Stimmungen und Themen. Integrieren Sie die Mubert API in Ihre Apps, KI-Agenten, Spiele und Live-Streams. Gema-freie Musik.

Mubert Inc
8 The Green Dover
Delaware US 19901
[email protected]

Select Language

German

© 2016 – 2026, Mubert Inc. Alle Musik, die auf *.mubert.com-Domains gesendet wird, wird (erstellt, komponiert, aufgenommen) von Künstlicher Intelligenz (Algorithmus, Software, Programm) erzeugt, die im Besitz von Mubert® Inc ist und nur von Mubert® Inc für den persönlichen Gebrauch lizenziert ist. Alle Rechte sind vorbehalten. Die öffentliche Vervielfältigung, Aufnahme, Verbreitung dieser Musik ist verboten.

Datenschutzerklärung

Nutzungsbedingungen

DMCA-Richtlinie

Mubert Render

Mubert API

Werkzeuge

Mubert Fusion

YouTube-Copyright-Prüfer

DMCA-Twitch-Prüfer

Instagram-Reels-Prüfer

TikTok-Sound-Prüfer

Weitere Produkte

Mubert für Streamer

Mubert für Unternehmen

Über

Blog

Häufig gestellte Fragen

Über

Partner

Kontakte

Generieren Sie Musik in über 200 Stimmungen und Themen. Integrieren Sie die Mubert API in Ihre Apps, KI-Agenten, Spiele und Live-Streams. Gema-freie Musik.

Mubert Inc
8 The Green Dover
Delaware US 19901
[email protected]

Select Language

German

Datenschutzerklärung

Nutzungsbedingungen

DMCA-Richtlinie

Mubert Render

Mubert API

Werkzeuge

Mubert Fusion

YouTube-Copyright-Prüfer

DMCA-Twitch-Prüfer

Instagram-Reels-Prüfer

TikTok-Sound-Prüfer

Weitere Produkte

Mubert für Streamer

Mubert für Unternehmen

Über

Blog

Häufig gestellte Fragen

Über

Partner

Kontakte

Generieren Sie Musik in über 200 Stimmungen und Themen. Integrieren Sie die Mubert API in Ihre Apps, KI-Agenten, Spiele und Live-Streams. Gema-freie Musik.

Mubert Inc
8 The Green Dover
Delaware US 19901
[email protected]

Select Language

German

Datenschutzerklärung

Nutzungsbedingungen

DMCA-Richtlinie

Mubert KI-Musik-API

Inhaltsverzeichnis

Install Mubert Skill

Authentifizierung

Lizenz

Antwort

Webhooks

Benutzerregistrierung

Benutzerverwaltung

Benutzerinformationen

Benutzer löschen

Liste der Kanäle

Benutzerinformationen

Antwort 200 OK

Musikstreaming

Anfrage

Antwort 200 OK

Parameter

Wiederholungsmodus

Parameter

Anfrage

Antwort

Intensität

Anfrage

Antwort

Generation neu starten

Anfrage

Antwort

Track-Generierung

Track erstellen

Anfrage

Parameter

Antwort

Anfrage

Text-zu-Musik

Anfrage

Parameter

Antwort

Intensität

Anfrage

Antwort

Generation neu starten

Anfrage

Antwort

Bild-zu-Musik

Anfrage

Parameter

BPM-/Tonart-Generierung

Anfrage

Antwort

Ähnliche generieren

Anfrage

Spurbearbeitung

Anfrage

Antwort 200 OK

Instrument(e) ersetzen:

Stiele ersetzen:

Instrument(e) löschen:

Stängel löschen:

Titelliste

Track-Shop

Mubert Musikbibliothek

Parameter

Anfrage

Antwort

Antwort

Anfrage

Antwort

Titel

Anfrage

Antwort

Anfrage

Antwort

Selbstbewusstsein

Transparent und flexibel

Transparent und flexibel

Testplan

49 $

Startup-Plan

199 $