Passer au contenu principal
POST
Référencer la piste source : les opérations basées sur un morceau existant ne nécessitent de mémoriser aucun id en amont, il suffit de passer task_id (le task_id de notre côté correspondant à la tâche qui a produit la piste source) + audio_index (le numéro du morceau dans music[] des résultats, indexé à partir de 1, 1 par défaut).
custom n’est ni requis ni déduit pour extend — omettez-le et l’extension fonctionne très bien ; s’il est passé, il est transmis tel quel à l’amont. custom=true prolonge en suivant les paroles de prompt ; avec custom=false ou omis, vous pouvez passer gpt_description (prompt d’inspiration) pour guider la direction.

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).
task_id
string
requis
Le task_id de notre côté correspondant à la tâche qui a produit la piste source. S’il manque ou si la source ne peut pas être résolue, un 400 est renvoyé dès la soumission.
audio_index
integer
défaut:"1"
Quel morceau du data.music[] du résultat de la tâche source (indexé à partir de 1 ; par défaut 1 ; une génération produit généralement 2 morceaux : index 1 et 2).
continue_at
integer
requis
À partir de quelle seconde poursuivre l’écriture.
version
string
défaut:"v5.5"
Version de génération : v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, affecte la qualité audio et la facturation ; par défaut v5.5 si non fournie, et une valeur invalide renvoie directement 400 dès la soumission.
custom
boolean
Inutile de le passer (non imposé pour extend). true=prolonger en suivant les paroles de prompt ; false=extension guidée par l’inspiration.
prompt
string
Paroles de l’extension. Prend effet lorsque custom=true.
gpt_description
string
Prompt d’inspiration. Prend effet lorsque custom=false ou lorsque custom est omis (guide la direction de l’extension).
title
string
Titre. Ne prend effet que lorsque custom=true.
tags
string
Tags de style. Ne prend effet que lorsque custom=true.
negative_tags
string
Tags de style à exclure. Ne prend effet que lorsque custom=true.
vocal_gender
string
Genre vocal : Male / Female. Fonctionne dans les deux modes.
style_weight
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.
weirdness_constraint
number
Créativité, 0.001.00 (alias weirdness). Ne prend effet que lorsque custom=true.
audio_weight
number
Poids de l’audio, 0.001.00. Ne prend effet que lorsque custom=true.
auto_lyrics
boolean
true = réécrire de manière créative les paroles fournies. Ne prend effet que lorsque custom=true.
persona_id
string
Identifiant de style Persona. Ne prend effet que lorsque custom=true.
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 le audio_url prolongé 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