Muziek

Muziek

Maak volledige nummers op basis van een beschrijving, van van je eigen lyrics en stijl. Elke aanvraag levert 2 takes op voor één prijs en is meestal in ongeveer een minuut klaar.

POST/v1/music
ModelIDPrijs per nummer

Maak een nummer

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"])

Een nummer wordt op de achtergrond gemaakt. POST /v1/music geeft meteen een id terug; vraag dit om de paar seconden op met GET /v1/music/{id} tot de status completed of failed is.

Parameters

Stuur prompt om een nummer te beschrijven, of schrijf het zelf met lyrics en style. Stuur niet beide mee.

modelstringverplicht
Een muziekmodel-ID uit de tabel.
promptstring
Hoe het nummer moet worden, maximaal 200 tekens.
lyricsstring
Je eigen songtekst, maximaal 3,000 tekens. Markeer secties met tags zoals [Verse] en [Chorus].
stylestring
Het genre, de sfeer, de instrumenten of de stem, tot 120 tekens.
exclude_stylestring
Stijlen of instrumenten die je wilt uitsluiten, maximaal 120 tekens.
titlestring
De titel van het nummer, maximaal 80 tekens.
instrumentalboolean
Geen zang. Werkt met prompt, of met style en zonder lyrics.

Het resultaat

Elk item in tracks
indexnumber
Het hoeveelste resultaat het is, beginnend bij 1. Gebruik dit als track bij het downloaden.
titlestring
De titel van het nummer. Als je er geen opgeeft, verzint het model er zelf een.
duration_secondsnumber
Hoe lang de take is.
stylestring
De stijl die het model heeft gebruikt, in zijn eigen woorden.
lyricsstring
De gezongen tekst. Laat leeg voor een instrumentaal nummer.
urlstring
Een link naar de MP3, 24 uur geldig. Haal het nummer opnieuw op voor een nieuwe link.

Download een take

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

Streamt de MP3. Nummers blijven 30 dagen bewaard.

Bekijk je nummers

GET/v1/music

Nieuwste eerst. Gebruik limit (maximaal 100) en after (de id van een nummer) om erdoorheen te bladeren.

Goed om te weten

  • Je betaalt pas als een nummer is geleverd. Mislukt het, dan kost het niets.
  • Een verzoek met de naam van een bekende artiest, of met de songtekst van iemand anders, kan worden geweigerd met de foutcode content_policy. Beschrijf in plaats daarvan het geluid.
  • De lengte van nummers varieert, meestal van minder dan een minuut tot ongeveer drieënhalve minuut. De lengte kun je niet instellen.

Geen officiële Suno API

Suno heeft geen eigen openbare API en Zurelay is niet verbonden aan Suno. Verzoeken lopen via capaciteit van derden, dus de beschikbaarheid kan veranderen. Lees de voorwaarden van Suno voordat je een nummer publiceert van verkoopt.

Vragen, of ontbreekt er iets? Vraag het ons supportteam en je krijgt antwoord per e-mail, meestal binnen een minuut.