Musique

Musique

Créez des chansons complètes à partir d'une description, ou à partir de vos propres paroles et de votre style. Chaque requête génère 2 versions pour un seul prix, et se termine généralement en une minute environ.

POST/v1/music
ModèleIDPrix par chanson

Créer une chanson

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

Le morceau est généré en arrière-plan. POST /v1/music répond immédiatement avec un identifiant ; interrogez GET /v1/music/{id} toutes les quelques secondes jusqu'à ce que son statut passe à completed ou failed.

Paramètres

Envoyez prompt pour décrire une chanson, ou écrivez-la vous-même avec lyrics et style. N'envoyez pas les deux.

modelstringrequis
Un ID de modèle musical issu du tableau.
promptstring
Ce que doit être la chanson, jusqu'à 200 caractères.
lyricsstring
Vos propres paroles, jusqu'à 3,000 caractères. Marquez les sections avec des balises telles que [Verse] et [Chorus].
stylestring
Le genre, l'ambiance, les instruments ou la voix, jusqu'à 120 caractères.
exclude_stylestring
Styles ou instruments à exclure, 120 caractères maximum.
titlestring
Le titre de la chanson, 80 caractères maximum.
instrumentalboolean
Sans voix. Fonctionne avec prompt, ou avec style et sans lyrics.

Le résultat

Chaque élément de tracks
indexnumber
Le numéro de la prise, à partir de 1. Utilisez-le comme track lors du téléchargement.
titlestring
Le titre du morceau. Le modèle en écrit un si vous n'en indiquez pas.
duration_secondsnumber
Durée de la prise.
stylestring
Le style utilisé par le modèle, dans ses propres mots.
lyricsstring
Les paroles chantées. Laissez vide pour un morceau instrumental.
urlstring
Un lien vers le MP3, valable 24 heures. Récupérez à nouveau le morceau pour en obtenir un nouveau.

Télécharger une prise

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

Flux acceptant le MP3. Les morceaux sont conservés pendant 30 jours.

Listez vos morceaux

GET/v1/music

Du plus récent au plus ancien. Accepte limit (jusqu'à 100) et after (l'identifiant d'une chanson) pour parcourir les résultats page par page.

Bon à savoir

  • Vous n'êtes facturé que lorsqu'un morceau est livré. En cas d'échec, c'est gratuit.
  • Une requête qui cite un artiste célèbre ou reprend les paroles de quelqu'un d'autre peut être refusée avec le code d'erreur content_policy. Décrivez plutôt le son.
  • La durée des morceaux varie, généralement de moins d'une minute à environ trois minutes et demie. Elle n'est pas réglable.

Ce n'est pas une API officielle de Suno

Suno ne propose pas d'API publique, et Zurelay n'est pas affilié à Suno. Les requêtes passent par une capacité tierce, la disponibilité peut donc varier. Consultez les conditions de Suno avant de publier ou de vendre un morceau.

Une question ou un élément manquant ? Contactez notre équipe d’assistance et nous vous répondrons par e-mail, généralement en moins d’une minute.