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).
array
erforderlich
Array aus 1–4 öffentlich zugänglichen Audio-URLs.
string
Standard:"v6"
Öffentliche Version: v6 / v6-wild / v6-mini. Standard ist v6; bei Verwendung von custom_model_id weglassen.
string
Vollständige UUID aus der Modellerstellungsaufgabe. Kann nicht mit version verwendet werden.
string
Songtext / Inhalt.
string
Titel.
string
Stil-Tags.
string
Auszuschließende Stil-Tags.
number
Stilgewichtung, 0.00–1.00.
number
Kreativitätsgewichtung, 0.00–1.00. Der alte Name weirdness_constraint wird unterstützt; neue Anfragen sollten weirdness verwenden.
number
Audiogewichtung, 0.00–1.00.
string
Gesangsgeschlecht: Male / Female.
boolean
true=den übergebenen Songtext kreativ umschreiben.
string
Stilvariation: off / normal / high / extra / max. Optional.
boolean
Standard:"false"
Aktiviert den Max-Modus; Abrechnung zum Doppelten des Standardpreises.
string
Audioausgabeformat: mp3 / m4a / wav.
Diese API akzeptiert 1–4 öffentlich erreichbare Audio-Links und sendet weder custom, instrumental, gpt_description, persona_id noch ein Zieldauerfeld.
Ergebnis abrufen: Dies ist eine asynchrone Aufgabe. Fragen Sie nach der Übermittlung alle 3–5 Sekunden den Aufgabenstatus ab. Die Generierung dauert meist 30–120 Sekunden; Zwischenstatus und Fortschritt ändern sich nicht zwingend in festen Schritten. Lesen Sie nach Abschluss audio_url aus data.result.music[]. Bei einem Fehler wird der abgezogene Betrag automatisch erstattet.

Response

integer
Antwort-Statuscode
array
Zurückgegebenes Daten-Array