Créer une chanson

Soumettez une nouvelle tâche de génération musicale, avec les modes inspiration, personnalisé et instrumental.

custom et instrumental doivent être fournis explicitement. Avec custom=false, renseignez gpt_description_prompt ; avec custom=true et instrumental=false, renseignez prompt.

Après la soumission, conservez data.jobId et utilisez Récupérer une tâche pour lire le résultat. Les règles de callback figurent dans la section « Notifications de callback » de cette page.

POST/suno/mj/submit/music

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.

custom*boolean

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

instrumental*boolean

Indique si la musique doit être instrumentale ; 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 et instrumental=false.

title?string

Titre de la chanson ; longueur maximale de 80 caractères.

Longueurlength <= 80

tags?string

Style/tags.

negative_tags?string

Tags à exclure.

style_weight?number

Valeur comprise entre 0~1.

Plage0 <= value <= 1

weirdness_constraint?number

Valeur comprise entre 0~1.

Plage0 <= value <= 1

audio_weight?number

Valeur comprise 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。

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/music' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "custom": true,
  "instrumental": false,
  "mv": "chirp-v5",
  "prompt": "Écrivez une chanson folk-pop chaleureuse, avec des couplets doux et un refrain mémorable",
  "title": "Dusk on Elm",
  "tags": "gentle, acoustic pop"
}'

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

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`