Suno Allgemeine Konventionen und Aufgabenabfrage
Suno
Suno Allgemeine Konventionen und Aufgabenabfrage
- Allgemeine Hinweise zur Suno-Musik-API: Authentifizierung, Lebenszyklus asynchroner Aufgaben, model / version, Referenz auf Quell-Audiospuren
- Aufgabenabfrage: GET /v1/music/tasks/:task_id, abfragen bis completed / failed
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: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.submitted → pending → completed / 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: unseretask_idder Aufgabe, die die Quell-Audiospur erzeugt hataudio_index: welcher Song aus dem Ergebnismusic[]dieser Aufgabe (1-basiert, Standard1; eine Generierung erzeugt in der Regel 2 Songs: 1 und 2)
Aufgabe abfragen: GET /v1/music/tasks/:task_id
Die von der Absende-API zurückgegebene, unsere
task_id.status completed oder failed ist. Nach Abschluss die Produkte aus data.result.music[] abrufen.
Response
Eindeutige Kennung der Aufgabe
Aufgabenstatus:
submitted / pending / completed / failedFortschritt: Warteschlange
10 → bereit 50 → fertig 100Ergebnisdaten