Skip to main content
POST
Der frühere Endpunkt POST /v1/music/generations/wav ist veraltet. Er bleibt vorübergehend kompatibel und entspricht dem neuen Endpunkt mit formats: ["wav"]. Neue Integrationen müssen POST /v1/music/generations/download verwenden.
Quellsong wählen: Übergeben Sie die task_id der Aufgabe, die das Quellaudio erzeugt hat. Mit audio_index wählen Sie einen Titel aus dem Ergebnis music[]. Der Index beginnt bei 1 und ist standardmäßig 1.

Authentifizierung

string
erforderlich
Alle Endpunkte erfordern einen Bearer Token. Den Schlüssel erhalten Sie auf der API-Key-Seite.

Anfrageparameter

string
Standard:"suno"
Modellname. Verwenden Sie suno; bei Auslassung ist suno der Standard.
string
erforderlich
Die Aufgaben-ID, die beim Erstellen des Quellsongs zurückgegeben wurde.Die Quellaufgabe muss zum aktuellen Konto gehören, abgeschlossen sein und eine herunterladbare Audiospur enthalten. Musikgenerierung, Verlängerung, Cover und Stems sind zulässig; reine Textaufgaben wie Lyrics oder BPM-Analyse nicht.
integer
Standard:"1"
Der Titel im music[]-Ergebnis der Quellaufgabe.
  • Index beginnt bei 1
  • Standard: 1
  • Darf die Anzahl der Quelltitel nicht überschreiten
string[]
Array der gewünschten Dateiformate mit mindestens einem Eintrag.Zulässige Werte: mp3, m4a, wav.Mehrere Formate sind gemeinsam möglich. Groß-/Kleinschreibung wird ignoriert, Duplikate werden entfernt und die Ergebnisreihenfolge entspricht der Anfrage.
string
Für ein einzelnes Format kann dieses Feld statt formats verwendet werden.Beispiel: "format": "mp3"
Verwenden Sie entweder formats oder format. Fehlen beide oder ist die Liste leer, wird HTTP 400 zurückgegeben.

Übermittlungsantwort

Bei Erfolg wird eine neue task_id für die Download-Aufgabe zurückgegeben.
data ist ein Array; lesen Sie data[0].task_id. Diese ID gehört zur neuen Download-Aufgabe und unterscheidet sich von der Quell-task_id in der Anfrage.

Download-Ergebnis abfragen

Verwenden Sie die Download-Aufgaben-ID:
Die Dateien sind meist bereits bei der Übermittlung vorbereitet. Fragen Sie sofort einmal ab. Ist der Status weder completed noch failed, pollen Sie alle 2 Sekunden bis maximal 60 Sekunden.

Abgeschlossen

Lesen Sie Downloads aus result.files[]:
result.wavUrl dient nur der Kompatibilität mit dem alten WAV-Endpunkt. Neuer Code soll immer result.files[] verwenden.

In Bearbeitung

Es gibt noch kein result. Pollen Sie weiter.

Fehlgeschlagen

Fehlgeschlagene Aufgaben werden automatisch erstattet und liefern cost: 0. Zeigen Sie error.message an und bieten Sie eine Wiederholung an.

Datei-URLs

Ergebnisse verwenden normalerweise die APIMart-Dateidomain. Scheitert die Übertragung in den Speicher, kann eine zeitlich nicht garantierte Upstream-CDN-URL zurückgegeben werden.
Laden Sie die Datei zeitnah herunter. Verwenden Sie temporäre URLs nicht als dauerhaften Speicher.

Fehler

Validierungsfehler geben vor Aufgabenerstellung und Abrechnung HTTP 400 zurück: HTTP 403 mit model_price_not_configured bedeutet, dass der Preis suno@download nicht konfiguriert ist; wenden Sie sich an den Plattform-Support.

Abrechnung und wiederholte Downloads

  • Eine Anfrage mit mehreren Formaten wird einmal berechnet
  • Eine erneute Anfrage für denselben Song verursacht eine neue Gebühr
  • Ein später angefordertes anderes Format verursacht ebenfalls eine neue Gebühr
  • Fehlgeschlagene Download-Aufgaben werden automatisch erstattet
Verwenden Sie bereits zurückgegebene Datei-URLs erneut und deaktivieren Sie die Download-Schaltfläche während einer Anfrage, um doppelte Gebühren zu vermeiden.

Migration vom alten Endpunkt

Der alte Endpunkt bleibt vorübergehend verfügbar; neuer Code muss /generations/download verwenden.

Response

integer
Antwortstatuscode; bei Erfolg 200
array
Daten der Übermittlungsantwort