Prolonger une chanson

Continuez la génération à partir d’un point précis d’une piste existante ; continue_at est exprimé en secondes.

music_id est un ID de piste, que vous pouvez obtenir via Téléverser un audio de référence. continue_at doit être supérieur ou égal à 0. Après la soumission, utilisez Récupérer une tâche pour lire le résultat.

POST/suno/mj/submit/extend

Authentification

bearerAuth

AuthentificationBearer <token>

Authentification avec Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

music_id*string

ID de la piste à prolonger.

continue_at*number

Point de départ du prolongement, en secondes ; doit être supérieur ou égal à 0.

Plage0 <= value

custom*boolean

Indique si le mode personnalisé est utilisé ; son absence entraîne un rejet.

gpt_description_prompt?string

Obligatoire lorsque custom=false ; longueur maximale de 500 caractères.

Longueurlength <= 500

prompt?string

Obligatoire lorsque custom=true ; utilisé comme paroles ou prompt de prolongement.

title?string

Titre ; longueur maximale de 80 caractères.

Longueurlength <= 80

tags?string

Style musical.

negative_tags?string

Tags à exclure.

style_weight?number

Toutes les valeurs sont comprises entre 0~1.

Plage0 <= value <= 1

weirdness_constraint?number

Toutes les valeurs sont comprises entre 0~1.

Plage0 <= value <= 1

audio_weight?number

Toutes les valeurs sont comprises entre 0~1.

Plage0 <= value <= 1

auto_lyrics?boolean

Indique si les paroles doivent être générées automatiquement.

vocal_gender?string

Seules les valeurs Male / Female sont prises en charge.

Valeurs autorisées

"Male"
"Female"

persona_id?string

Persona ID。

isStorage?boolean

Indique si le résultat doit être transféré vers un autre stockage.

hookUrl?string

Adresse de callback utilisateur facultative. Seuls les ports 80, 443, 8080 et 8443 sont pris en charge ; si elle est renseignée, la plateforme relaie les notifications.

Corps de réponse

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/extend' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "continue_at": 62.5,
  "custom": true,
  "prompt": "Prolongez le refrain précédent en ajoutant une batterie plus puissante et des chœurs",
  "title": "Dusk on Elm Extended",
  "tags": "cinematic pop, choir"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

`application/json`

`application/json`