Passer au contenu principal
POST
Cette interface n’a pas de dimension de version : ne passez pas version — s’il est fourni, il est ignoré et n’a aucun impact sur la facturation.

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).
prompt
string
requis
Paroles / contenu.
lyrics_model
string
Modèle de paroles : classic / remi (transmis tel quel à l’amont ; si non fourni, la valeur par défaut de l’amont est utilisée).
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 (pendant la génération, status est pending et progress passe de 10 en file d’attente → 50 prêt → 100 terminé). Une fois la tâche terminée, le résultat contient le texte des paroles générées. 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