Skip to content

Übersicht ​

Suno-API-Dokumentation ​

Grundinformationen ​

API-Endpunkte ​

  • Standard:
    https://{BASE_URL}/suno/submit/music
    https://{BASE_URL}/suno/fetch

Modellunterstützung ​

Unterstützte Modelle ​

  • chirp-v3-0 (Version v3.0)
  • chirp-v3-5 (Version v3.5)
  • chirp-v4 (Version v4.0)
  • chirp-auk (Version v4.5)
  • chirp-v5 (Version v5.0)

Callback-Benachrichtigungen ​

  • Unterstützt notify_hook-Callback-URL
  • Anforderungen:
    • Methode: POST
    • Empfangene Daten: Task-Datenstruktur

Verwendungsschritte ​

1. Suno-Aufgabe erstellen ​

2. Aufgabenfortschritt abfragen ​

Datenstrukturen ​

Task-Objekt ​

FeldTypBeispielBeschreibung
task_idstringf4a94d75-087b-4bb1-bd45-53ba293faf96Aufgaben-ID
actionstringMUSICAufgabentyp: MUSIC (Song erzeugen), LYRICS (Text erzeugen)
statusstringSUCCESSStatus: NOT_START (nicht gestartet), SUBMITTED (übermittelt), QUEUED (Warteschlange), IN_PROGRESS (läuft), FAILURE (fehlgeschlagen), SUCCESS (erfolgreich)
submitTimenumber1689231405854Übermittlungszeit
startTimenumber1689231442755Startzeit
finishTimenumber1689231544312Endzeit
failReasonstring[Invalid parameter] Invalid valueFehlergrund (bei Fehlschlag)
dataobject-Daten: Musik (Array) oder Text (einzelnes Objekt)

Musik-Fortsetzung ​

  • Der Parameter task_id muss übergeben werden, um die Aufgabe anzugeben