生成歌詞

提交成功後儲存 data.jobId，透過查詢任務取得候選歌詞。lyrics_model 支援 classic 和 remi；省略時使用 classic。

查詢任務完成後，候選歌詞位於回應的 data.data.data.lyrics。每項使用 prompt 回傳完整歌詞，並包含 title 和 tags；不要讀取未回傳的 text 欄位。

POST/suno/mj/submit/lyrics

授權

bearerAuth

授權Bearer <token>

使用 Authorization: Bearer your-api-key 進行認證。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

prompt*string

歌詞生成提示詞，長度上限為 500 個字元。

長度length <= 500

lyrics_model?string

歌詞模型；支援 classic、remi，預設為 classic。

預設值"classic"

可用值

"classic"
"remi"

hookUrl?string

選用的使用者回呼網址。僅支援 80、443、8080、8443 連接埠；填寫後由平台轉送通知。

回應主體

`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": "寫一首關於夏夜海邊重逢的中文流行歌詞，副歌令人印象深刻",
  "lyrics_model": "classic"
}'

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

授權

請求主體

回應主體

200application/json

400application/json

429application/json

`application/json`

`application/json`

`application/json`