Ajouter un accompagnement

Ajoutez une couche instrumentale à un audio existant, par exemple un chant a cappella ou une mélodie de référence.

Renseignez music_id avec l’ID de piste obtenu via Téléverser un audio de référence. Les ID de piste provenant d’autres sources, notamment de la génération de chansons, peuvent ne pas convenir à cette opération. Après la soumission, conservez data.jobId et utilisez Récupérer une tâche pour obtenir le statut du traitement et l’audio final.

POST/suno/mj/submit/add-instrumental

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 l’audio auquel ajouter un accompagnement.

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.

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-instrumental' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": false,
  "mv": "chirp-v5",
  "gpt_description_prompt": "Ajoutez un accompagnement acoustic pop chaleureux à ce chant a cappella, avec une batterie discrète et un refrain ample",
  "title": "Acoustic Arrangement",
  "tags": "acoustic pop, warm, soft drums"
}'

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