Skip to main content
POST

Authorizations

string
erforderlich
Alle Schnittstellen erfordern eine Authentifizierung mit einem Bearer TokenAPI-Key abrufen:Besuchen Sie die API-Key-Verwaltungsseite, um Ihren API-Key zu erhaltenFügen Sie bei der Verwendung im Request-Header hinzu:

Body

string
Standard:"suno"
Audiomodell. Übergeben Sie derzeit suno (ohne Angabe standardmäßig suno).
string
Standard:"v6"
Öffentliche Version: v6 / v6-wild / v6-mini; Standard bei Auslassung: v6.
string
erforderlich
Beschreibung des Soundeffekts; fehlt sie, wird bereits beim Absenden 400 zurückgegeben (keine Abrechnung). Verwenden Sie nach Möglichkeit englische Prompts für die besten Ergebnisse.
string
Standard:"one-shot"
Art des Soundeffekts: one-shot (Standard, einmalig) / loop (loopfähig).
integer
Tempo, 1300; Werte außerhalb des Bereichs geben bereits beim Absenden direkt 400 zurück.
string
Tonarten-Enumeration: Dur-Tonarten C / C# / D / D# / E / F / F# / G / G# / A / A# / B; Moll-Tonarten hängen m an (Cm / C#m / … / Bm). Es wird nur die Kreuz-Schreibweise (#) unterstützt; Tonarten mit b (Db / Eb usw.) und B# geben 400 zurück (key param error).
string
Audioausgabeformat: mp3 / m4a / wav.
Diese API unterstützt keine benutzerdefinierten Modelle, Max, variety oder Zieldauer.
Ergebnis abrufen: Diese API erstellt eine asynchrone Aufgabe. Rufen Sie nach der Übermittlung alle 3–5 Sekunden GET /v1/music/tasks/{task_id} ab, bis status den Wert completed oder failed hat. Während der Verarbeitung kann status pending oder processing sein; progress ist eine Ganzzahl von 0 bis 100, ändert sich aber nicht zwingend in festen Schritten. Lesen Sie nach Abschluss audio_url aus data.result.music[]. Bei einem Fehler steht der Grund in data.error.message; der abgezogene Betrag wird automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array