Skip to main content
GET
Allgemeine Suno-V6-Regeln und Aufgabenabfrage
Alle Suno-Generierungs-, Bearbeitungs- und Werkzeug-APIs verwenden asynchrone Aufgaben: Senden Sie den Vorgang, übernehmen Sie task_id und fragen Sie das Ergebnis über diese API ab.

Authentifizierung

string
erforderlich
Bearer-Token-Authentifizierung: Authorization: Bearer <YOUR_API_KEY>.
Besuchen Sie die Seite zur API-Key-Verwaltung, um einen API Key zu erhalten.

V6-Version und Modellauswahl

Öffentliche Modelle unterstützen folgende Versionen:
  • v6
  • v6-wild
  • v6-mini
Der Hauptendpunkt benötigt entweder version oder die von einer Modellerstellungsaufgabe gelieferte custom_model_id. Bearbeitungsvorgänge mit Versionsunterstützung verwenden ohne version standardmäßig v6. Öffentliche version und custom_model_id dürfen nicht gemeinsam gesendet werden.
custom: true wählt den Modus für benutzerdefinierte Liedtexte, custom_model_id ein trainiertes benutzerdefiniertes Modell. Dies sind unterschiedliche Konzepte; der Liedtextmodus wechselt nicht automatisch zur Modellpreisstufe.

Allgemeine V6-Generierungsoptionen

Senden Sie die folgenden Felder nur, wenn sie beim jeweiligen Endpunkt aufgeführt sind: Lassen Sie nicht unterstützte Felder weg und senden Sie nicht überall max_mode: false. variety und Max-Modus sind unabhängig; variety: "max" aktiviert keine Max-Abrechnung.

Text- und Gewichtungsgrenzen

Neue Anfragen an Vorgangs-APIs verwenden weirdness; weirdness_constraint ist ein Kompatibilitätsalias. Die Hauptgenerierung verwendet weiterhin weirdness_constraint. Textlängen werden in Unicode-Zeichen berechnet.

Referenz-Quellspur

Auf Basis vorhandener Werke:
  • task_id: API-Mart-Aufgaben-ID der ausgegebenen Audiospur.
  • audio_index: Ursprüngliche Position in data.result.music[] der Quellaufgabe, beginnend bei 1; Standardwert ist 1.
Zeigen Sie die tatsächlich im Array enthaltene Anzahl an und fixieren Sie sie nicht auf 2. Auch bei geänderter Anzeigereihenfolge müssen Folgevorgänge den Index im ursprünglichen Ergebnis verwenden.
Neue Anfragen referenzieren die Quellspur mit task_id + audio_index; audio_id, music_id oder audio_url sind kein Ersatz. Fehlt die Quellaufgabe oder liegt der Index außerhalb des Bereichs, wird 400 zurückgegeben.

Übermittlungsantwort

Lesen Sie die Aufgaben-ID aus data[0].task_id. submitted bedeutet nur, dass die Aufgabe angenommen wurde, nicht dass Audio oder andere Endprodukte bereits vorliegen.

Aufgabe abfragen

GET /v1/music/tasks/{task_id} Mit ?language=zh erhalten Sie unterstützte Übersetzungen von Fehlermeldungen. Dieser Parameter ändert nicht die Sprache des Songs oder Liedtexts.
string
erforderlich
Von der Übermittlungs-API zurückgegebene Aufgaben-ID.
Warten Sie zunächst etwa 3 Sekunden und fragen Sie dann alle 5–10 Sekunden ab, bis data.status completed oder failed ist. Nach dem Neuladen kann dieselbe Aufgaben-ID weiterverwendet werden. Senden Sie bezahlte POST-Anfragen bei einem Netzwerk-Timeout nicht automatisch erneut.

Abfrageantwort

integer
Antwortstatuscode.
object
Aufgabeninformationen.

Ergebnisverarbeitung

  • Musikergebnisse befinden sich normalerweise in data.result.music[]; Downloads, Liedtexte, MIDI, Persona und benutzerdefinierte Modelle verwenden jedoch eigene Ergebnisstrukturen.
  • duration ist die tatsächliche Dauer und kann Dezimalstellen enthalten; die Zieldauer muss nicht exakt dem Endergebnis entsprechen.
  • Der Gewichtungswert 0 ist gültig und darf nicht durch eine Falsy-Prüfung in JavaScript ausgeblendet werden.
  • audio_url endet nicht garantiert auf .mp3. Verwenden Sie zum Abspielen oder Herunterladen die tatsächlich zurückgegebene URL.
  • Behalten Sie bei status="unknown" die Aufgaben-ID bei und ermöglichen Sie manuelles Aktualisieren, ohne automatisch neue Aufgaben zu erstellen.
AbortController kann Browseranfragen und Abfragen stoppen, aber nicht die serverseitige Aufgabe. Derzeit gibt es keinen Endpunkt zum Abbrechen einer gesendeten Suno-Aufgabe.