Zum Hauptinhalt springen
GET
Suno Allgemeine Konventionen und Aufgabenabfrage
Diese Seite enthält die allgemeinen Konventionen für alle Suno-Musik-APIs und wird zusammen mit der jeweiligen Einzeldokumentation der Endpunkte verwendet. Alle Generierungs- / Bearbeitungs-APIs sind asynchrone Aufgaben: Beim Absenden erhalten Sie eine task_id, anschließend fragen Sie die Abfrage-API auf dieser Seite ab, um das Ergebnis zu erhalten.

Authentifizierung

Alle Anfragen müssen im Anfrage-Header Folgendes mitführen:
Besuchen Sie die Seite zur API-Key-Verwaltung, um einen API Key zu erhalten.

Aufgabenlebenszyklus (alle APIs sind asynchron)

1

Absenden

POST /v1/music/generations/<operation> → gibt sofort unsere task_id zurück:
2

Abfragen

GET /v1/music/tasks/:task_id bis status completed oder failed ist. Während der Generierung ist status pending und progress läuft von Warteschlange 10 → bereit 50 → fertig 100. Empfohlenes Abfrageintervall 3–5s; die Musikgenerierung dauert in der Regel 30–120s.
3

Ergebnis abrufen

Nach Abschluss audio_url / image_url / video_url usw. aus data.result.music[] abrufen.
Statusverlauf der Aufgabe: submittedpendingcompleted / failed. Bei einem Fehlschlag gibt data.error.message den Grund an, und das vorab reservierte Guthaben wird automatisch zurückerstattet.

Version

v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, beeinflusst Klangqualität und Abrechnung; ohne Angabe wird die Standardversion verwendet. Verfügbare Versionen und Standardwerte unterscheiden sich je Endpunkt — manche unterstützen nur eine Teilmenge, und manche haben gar keine Versionsdimension; maßgeblich ist die jeweilige Endpunkt-Dokumentation.

Quell-Audiospur referenzieren: task_id + audio_index

Für Operationen auf Basis vorhandener Songs (Fortsetzen / Cover / Stem-Trennung / Gesang hinzufügen / Zuschneiden …) müssen Sie sich keine vorgelagerte id merken, übergeben Sie nur:
  • task_id: unsere task_id der Aufgabe, die die Quell-Audiospur erzeugt hat
  • audio_index: welcher Song aus dem Ergebnis music[] dieser Aufgabe (1-basiert, Standard 1; eine Generierung erzeugt in der Regel 2 Songs: 1 und 2)
Wenn die Quelle nicht aufgelöst werden kann (Aufgabe nicht abgeschlossen / Index außerhalb des Bereichs / task_id nicht gefunden), wird bereits beim Absenden ein 400 zurückgegeben.

Aufgabe abfragen: GET /v1/music/tasks/:task_id

task_id
string
erforderlich
Die von der Absende-API zurückgegebene, unsere task_id.
Fragen Sie diese API ab, bis status completed oder failed ist. Nach Abschluss die Produkte aus data.result.music[] abrufen.

Response

task_id
string
Eindeutige Kennung der Aufgabe
status
string
Aufgabenstatus: submitted / pending / completed / failed
progress
integer
Fortschritt: Warteschlange 10 → bereit 50 → fertig 100
data
object
Ergebnisdaten