Musik

Musik

Erstelle komplette Songs aus einer Beschreibung oder aus deinen eigenen Lyrics und deinem Stil. Jede Anfrage erzeugt 2 Takes zu einem Preis und ist in der Regel in etwa einer Minute fertig.

POST/v1/music
ModellIDPreis pro Song

Einen Song erstellen

import os
import time
import requests
api = "https://api.zurelay.com/v1"
headers = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
song = requests.post(f"{api}/music", headers=headers, json={
    "model": "suno-v6",
    "prompt": "A cheerful acoustic folk song about morning coffee",
}).json()
while song["status"] in ("queued", "in_progress"):
    time.sleep(5)
    song = requests.get(f"{api}/music/{song['id']}", headers=headers).json()
for track in song["tracks"]:
    print(track["title"], track["url"])

Ein Song wird im Hintergrund erstellt. POST /v1/music antwortet sofort mit einer ID; frag sie mit GET /v1/music/{id} alle paar Sekunden ab, bis der Status completed oder failed ist.

Parameter

Sende prompt, um einen Song zu beschreiben, oder schreib ihn selbst mit lyrics und style. Beides zusammen geht nicht.

modelstringerforderlich
Eine Musikmodell-ID aus der Tabelle.
promptstring
Wie der Song sein soll, bis zu 200 Zeichen.
lyricsstring
Deine eigenen Songtexte mit bis zu 3,000 Zeichen. Markiere Abschnitte mit Tags wie [Verse] und [Chorus].
stylestring
Genre, Stimmung, Instrumente oder Stimme, bis zu 120 Zeichen.
exclude_stylestring
Stile oder Instrumente, die ausgeschlossen werden sollen, bis zu 120 Zeichen.
titlestring
Der Titel des Songs, maximal 80 Zeichen.
instrumentalboolean
Kein Gesang. Funktioniert mit prompt oder mit style und ohne lyrics.

Das Ergebnis

Jedes Element in tracks
indexnumber
Die Nummer des Takes, beginnend bei 1. Nutze sie beim Download als track.
titlestring
Der Titel des Songs. Wenn du keinen angibst, denkt sich das Modell einen aus.
duration_secondsnumber
Wie lang der Take ist.
stylestring
Der Stil, den das Modell verwendet hat, in seinen eigenen Worten.
lyricsstring
Der gesungene Text. Leer lassen für ein Instrumental.
urlstring
Ein Link zur MP3, 24 Stunden lang gültig. Ruf den Song erneut ab, um einen neuen Link zu bekommen.

Lade einen Take herunter

GET/v1/music/{id}/content?track=1

Streams, die MP3 annehmen. Songs werden 30 Tage lang aufbewahrt.

Liste deine Songs auf

GET/v1/music

Neueste zuerst. Nimmt limit (bis zu 100) und after (die ID eines Songs) entgegen, um durch die Ergebnisse zu blättern.

Gut zu wissen

  • Du zahlst nur, wenn ein Song geliefert wird. Schlägt die Generierung fehl, ist sie kostenlos.
  • Eine Anfrage, die einen berühmten Künstler nennt oder Songtexte von anderen verwendet, kann mit dem Fehlercode content_policy abgelehnt werden. Beschreibe stattdessen den Sound.
  • Songs sind unterschiedlich lang, meist zwischen unter einer Minute und etwa dreieinhalb Minuten. Die Länge lässt sich nicht festlegen.

Keine offizielle Suno-API

Suno hat keine eigene öffentliche API, und Zurelay steht in keiner Verbindung zu Suno. Anfragen laufen über Kapazitäten von Drittanbietern, deshalb kann sich die Verfügbarkeit ändern. Lies die Nutzungsbedingungen von Suno, bevor du einen Song veröffentlichst oder verkaufst.

Fragen oder fehlt etwas? Frag unser Support-Team und wir antworten per E-Mail, meist innerhalb einer Minute.