Passer au contenu principal
POST

Authorizations

Authorization
string
requis
Toutes les interfaces nécessitent une authentification via Bearer TokenObtenir la clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APILors de l’utilisation, ajoutez dans l’en-tête de la requête :

Body

model
string
défaut:"suno"
Modèle audio. Actuellement, passez suno (par défaut suno si non fourni).
audio_urls
array
requis
Tableau de 1 à 4 URL audio accessibles publiquement.
version
string
défaut:"v5.5"
Version de génération : v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, affecte la qualité audio et la facturation ; si non fournie, v5.5 par défaut.
prompt
string
Paroles / contenu.
title
string
Titre.
tags
string
Tags de style.
negative_tags
string
Tags de style à exclure.
style_weight
number
Poids du style, 0.001.00.
weirdness_constraint
number
Créativité, 0.001.00 (alias weirdness).
audio_weight
number
Poids de l’audio, 0.001.00.
vocal_gender
string
Genre vocal : Male / Female.
auto_lyrics
boolean
true = réécrire de manière créative les paroles fournies.
Récupérer le résultat : cette interface est une tâche asynchrone. Après soumission, vous obtenez un task_id ; interrogez GET /v1/music/tasks/{task_id} à intervalles de 3 à 5 s jusqu’à ce que status soit completed ou failed (la génération musicale prend généralement 30 à 120 s ; pendant la génération, status est pending et progress évolue : en file d’attente 10 → prêt 50 → terminé 100). Une fois terminé, récupérez audio_url dans data.result.music[]. En cas d’échec, data.error.message indique la raison et le quota pré-déduit est automatiquement remboursé.

Response

code
integer
Code de statut de la réponse
data
array
Tableau de données renvoyées