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.
/v1/musicCréer une chanson
import osimport timeimport requestsapi = "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 avecstyleet sanslyrics.
Le résultat
indexnumber- Le numéro de la prise, à partir de 1. Utilisez-le comme
tracklors 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
/v1/music/{id}/content?track=1Flux acceptant le MP3. Les morceaux sont conservés pendant 30 jours.
Listez vos morceaux
/v1/musicDu 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
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.