Skip to main content
POST
Piste source : la source doit provenir d’une tâche d’import créée avec POST /v1/music/generations/uploadTask. Transmettez sa task_id et sélectionnez une piste de data.result.music[] avec audio_index (indexé à partir de 1, défaut 1). Une tâche de génération normale ne peut pas servir de source.
custom contrôle les champs applicables. Même sans effet dans le mode choisi, tout champ envoyé doit respecter les exigences de type, de plage et de longueur. Avec custom=true, les champs de paroles et de style s’appliquent et gpt_description est ignoré. Avec custom=false, seul gpt_description s’applique et il est obligatoire ; son absence renvoie 400. vocal_gender s’applique dans les deux modes. Si custom est omis, le serveur l’infère à partir de prompt, puis gpt_description, puis tags ou title.

Authorizations

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

string
défaut:"suno"
Modèle audio. Actuellement, passez suno (par défaut suno si non fourni).
string
requis
task_id renvoyée par POST /v1/music/generations/uploadTask. Les tâches de génération normales ne sont pas acceptées. Une source absente ou invalide renvoie 400 lors de la soumission.
integer
défaut:"1"
Sélectionne une piste dans data.result.music[] de la tâche source (indexé à partir de 1 ; défaut 1).
string
défaut:"v6"
Version publique : v6 / v6-wild / v6-mini. Valeur par défaut v6 ; omettez-la avec custom_model_id.
string
UUID complet renvoyé par la tâche de création du modèle. Incompatible avec version.
boolean
true=mode personnalisé (prompt utilisé comme paroles) ; false=mode inspiration (utilise gpt_description) ; si omis, déduit du contenu (voir l’avertissement ci-dessus).
string
Paroles. Prend effet lorsque custom=true (ignoré en mode inspiration).
string
Prompt d’inspiration. Obligatoire lorsque custom=false — s’il manque, la requête échoue avec 400 dès la soumission (rien n’est facturé).
string
Titre. Ne prend effet que lorsque custom=true.
string
Tags de style. Ne prend effet que lorsque custom=true.
string
Tags de style à exclure. Ne prend effet que lorsque custom=true.
number
Poids du style, 0.001.00 (les valeurs hors plage renvoient directement 400 dès la soumission). Ne prend effet que lorsque custom=true.
number
Pondération de créativité, de 0.00 à 1.00. L’ancien nom weirdness_constraint reste accepté ; utilisez weirdness pour les nouvelles requêtes.
number
Poids de l’audio, 0.001.00. Ne prend effet que lorsque custom=true.
string
Genre vocal : Male / Female. Fonctionne dans les deux modes.
string
Variation de style : off / normal / high / extra / max.
boolean
défaut:"false"
Active le mode Max. Nécessite le mode personnalisé et est facturé deux fois le prix standard.
string
Format audio de sortie : mp3 / m4a / wav. Cet endpoint ne prend pas en charge de durée cible.
Cette API ne prend en charge ni auto_lyrics, ni persona_id, ni instrumental, ni la durée cible.
Obtenir le résultat : interrogez la tâche asynchrone jusqu’à sa fin. La génération prend généralement 30 à 120 secondes et la progression n’évolue pas forcément à intervalles fixes. Une fois terminée, lisez audio_url dans data.result.music[]. En cas d’échec, le montant débité est remboursé automatiquement.

Response

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