Générer des paroles

Générez des propositions de paroles à partir d’un prompt et récupérez le résultat via la tâche.

Après une soumission réussie, conservez data.jobId et utilisez Récupérer une tâche pour obtenir les propositions de paroles. lyrics_model prend en charge classic et remi ; si le champ est omis, classic est utilisé.

Une fois la tâche terminée, les propositions de paroles se trouvent dans data.data.data.lyrics de la réponse de récupération. Chaque élément renvoie les paroles complètes dans prompt, avec title et tags ; ne lisez pas un champ text qui n’a pas été renvoyé.

POST/suno/mj/submit/lyrics

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.

prompt*string

Prompt de génération de paroles ; longueur maximale de 500 caractères.

Longueurlength <= 500

lyrics_model?string

Modèle de paroles ; prend en charge classic et remi, avec classic par défaut.

Valeur par défaut"classic"

Valeurs autorisées

"classic"
"remi"

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/lyrics' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Écrivez des paroles pop en chinois sur des retrouvailles au bord de la mer un soir d’été, avec un refrain mémorable",
  "lyrics_model": "classic"
}'

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

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

429application/json

`application/json`

`application/json`

`application/json`