Skip to main content
POST
custom contrôle l’interprétation des champs texte. Avec custom=true, prompt contient les paroles et title, style, negative_tags, auto_lyrics, persona_id s’appliquent. Avec custom=false, prompt contient une inspiration et les champs du mode personnalisé sont ignorés. style_weight, weirdness_constraint, audio_weight et vocal_gender sont validés et appliqués dans les deux modes.
Cet endpoint emploie des noms légèrement différents : style au lieu de tags.

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).
boolean
défaut:"false"
false = mode inspiration ; true = mode personnalisé (prompt sert de paroles). Par défaut false.
boolean
défaut:"false"
true = musique instrumentale pure, sans voix. Par défaut false.
string
Version publique : v6 / v6-wild / v6-mini. Ce champ ou custom_model_id est obligatoire ; omettez-le avec un modèle personnalisé.
string
UUID complet de la tâche de modèle personnalisé créée. Incompatible avec version et persona_id ; ce champ applique la tarification du modèle personnalisé.
string
Inspiration/paroles. Obligatoire avec custom=false, 3 000 caractères maximum ; également obligatoire avec custom=true et instrumental=false, 5 000 caractères maximum. Facultatif pour un instrumental personnalisé.
string
Titre du mode personnalisé, 80 caractères maximum. Ignoré lorsque custom=false.
string
Tag de style en mode personnalisé, 1 000 caractères maximum. Ignoré lorsque custom=false.
string
Tags de style négatifs (styles que vous ne voulez pas). Ne prend effet que lorsque custom=true.
boolean
true = réécrire de manière créative les paroles fournies. Ne prend effet que lorsque custom=true.
string
ID de style Persona. S’applique uniquement avec custom=true et est incompatible avec custom_model_id.
string
Genre vocal : Male / Female (m / f / male / female sont également acceptés et normalisés par le backend). Fonctionne dans les deux modes.
number
Pondération du style, de 0.00 à 1.00. Validée et appliquée dans les deux modes.
number
Indice de créativité, de 0.00 à 1.00. Validé et appliqué dans les deux modes.
number
Pondération audio, de 0.00 à 1.00. Validée et appliquée dans les deux modes.
string
Variation de style : off / normal / high / extra / max. Facultatif, sans valeur par défaut fixe.
boolean
défaut:"false"
Indique s’il faut activer le mode Max. Nécessite custom=true et coûte deux fois le prix normal.
string
Format audio de sortie : mp3 / m4a / wav. S’il est omis, le service choisit la valeur par défaut.
integer
Durée cible de 10 à 360 secondes. Disponible uniquement avec custom=true ; la durée finale dépend du résultat de la tâche.
Obtenir le résultat : interrogez la tâche asynchrone toutes les 3 à 5 secondes. La génération prend généralement 30 à 120 secondes ; l’état peut être pending ou processing et la progression n’évolue pas forcément à intervalles fixes. Une fois terminée, lisez audio_url dans data.result.music[] (image_url, video_url, title, duration, etc. sont également disponibles). 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