Ajouter des voix

Obtenez d’abord un ID de piste via Téléverser un audio de référence, puis renseignez music_id. Un ID de piste renvoyé par la génération d’une chanson ne convient pas à cette opération.

Avec custom=true, prompt contient les paroles ou le prompt vocal. Après une soumission réussie, conservez data.jobId, puis utilisez Récupérer une tâche pour attendre le résultat ; status: SUCCESS dans la réponse de soumission ne signifie pas que l’audio est déjà généré.

POST/suno/mj/submit/add-vocals

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 piste obtenu en téléversant un audio de référence. Un ID de piste renvoyé par la génération d’une chanson ne convient pas à cette opération.

custom*boolean

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

mv?string

Version du modèle musical ; utilise chirp-v5 si le champ est omis.

Valeur par défaut"chirp-v5"

Valeurs autorisées

"chirp-v5-5"
"chirp-v5"
"chirp-v4-5+"
"chirp-v4-5"
"chirp-v4-5-all"
"chirp-v4"
"chirp-v3-5"
"chirp-v3-0"

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 vocal.

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

vocal_gender?string

Seules les valeurs Male / Female sont prises en charge.

Valeurs autorisées

"Male"
"Female"

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/add-vocals' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": true,
  "mv": "chirp-v5",
  "prompt": "Ajoutez à cette mélodie des couplets et un refrain chaleureux en chinois, avec une voix féminine",
  "title": "Voice Layer",
  "tags": "mandopop, female vocal",
  "vocal_gender": "Female"
}'

{
  "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`