Téléverser un audio de référence

Soumettez une URL audio accessible publiquement pour obtenir un ID de piste utilisable pour les reprises, le prolongement ou l’ajout de voix.

Cette interface reçoit audio_url dans un corps JSON ; il ne s’agit pas d’un téléversement de fichier Multipart. Choisissez un traitement synchrone ou asynchrone avec is_async.

POST/suno/mj/submit/upload

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.

audio_url*string

Adresse audio accessible publiquement.

is_async?boolean

Indique si le téléversement est asynchrone ; vaut false par défaut. Un succès synchrone renvoie généralement music_id directement.

Valeur par défautfalse

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/upload' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/reference-vocal.wav",
  "is_async": false
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "music_id": "MUSIC_ID"
  }
}

Traiter le résultat du téléversement

Téléversement synchrone : avec is_async=false (valeur par défaut), lisez l’ID de piste dans data.music_id après un succès.
Téléversement asynchrone : avec is_async=true, conservez data.jobId après une soumission réussie, puis utilisez Récupérer une tâche pour attendre la fin du traitement. L’ID de piste final se trouve dans data.data.data.musics[].musicId.

Dans la réponse asynchrone, status: SUCCESS signifie uniquement que la tâche a été acceptée, et non que le téléversement est terminé. Transmettez l’ID de piste dans music_id pour Reprise dans un autre style, Prolonger une chanson ou Ajouter des voix ; un ID de tâche ne peut pas remplacer un ID de piste.

Téléverser un audio de référence

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

Traiter le résultat du téléversement

`application/json`

`application/json`