curl --request POST \
  --url https://api.aiid.edu.kg/suno/submit/music \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_music",
  "upstream_model": "suno-v5",
  "prompt": "Imitating \"Billie Jean,\" create a DJ song with the theme of \"the artificial intelligence revolution.\"",
  "make_instrumental": false
}
'

{
  "code": "success",
  "message": "",
  "data": "task_xxx"
}

音樂生成任務格式

建立音樂生成任務

音樂生成提交介面，與舊 /suno/submit/music 路徑相容。返回任務 ID，後續可透過 /suno/fetch/{task_id} 查詢。

音樂生成任務提交介面。路徑維持 /suno/submit/music，實際可透過 upstream_model、music_model、engine、model_id 或 modelId 選擇生成引擎。建立介面返回 task_id，之後用 /suno/fetch/{task_id} 查詢輸出。

提示詞描述模式

適合只描述風格、情緒、語言、歌手類型和場景，由模型自動生成歌曲內容。

{
 "model": "suno_music",
 "upstream_model": "suno-v5",
 "prompt": "Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution."",
 "make_instrumental": false
}

輕音樂或純伴奏

可使用 light_music=true 或 make_instrumental=true。light_music 表示偏輕音樂/背景音樂，make_instrumental 表示不生成演唱人聲。

{
 "model": "suno_music",
 "upstream_model": "minimax-music-v2.6",
 "prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
 "light_music": true,
 "make_instrumental": true
}

歌詞高級模式

適合業務側已經準備好歌詞，需要指定標題和風格標籤。可傳 custom_mode=true，歌詞欄位可用 lyrics、lyric、custom_lyrics 或 customLyrics。

{
 "model": "suno_music",
 "upstream_model": "mureka-v9",
 "custom_mode": true,
 "title": "Summer Sea Breeze",
 "tags": "electro pop, female vocal, bright summer",
 "lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}

查詢

建立成功後保存回傳的 data 任務 ID，例如 task_xxx，呼叫 GET /suno/fetch/{task_id} 查詢狀態、音訊位址、封面、標題、歌詞和上游回傳的原始片段資訊。

POST

suno

submit

music

curl --request POST \
  --url https://api.aiid.edu.kg/suno/submit/music \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno_music",
  "upstream_model": "suno-v5",
  "prompt": "Imitating \"Billie Jean,\" create a DJ song with the theme of \"the artificial intelligence revolution.\"",
  "make_instrumental": false
}
'

{
  "code": "success",
  "message": "",
  "data": "task_xxx"
}

授權

Authorization

string

header

必填

使用 Bearer Token 認證。格式: Authorization: Bearer sk-xxxxxx

主體

application/json

model

enum<string>

必填

固定傳 suno_music。

可用選項:

suno_music

範例:

"suno_music"

prompt

string

必填

在提示詞描述模式下，作為音樂風格、情緒和場景；在歌詞高級模式下，可作為歌詞相容欄位。

upstream_model

string

生成引擎選擇值。

範例:

"suno-v5"

music_model

string

upstream_model 的相容別名。

engine

string

upstream_model 的相容別名。

model_id

string

上游模型 ID 相容欄位。

modelId

string

model_id 的 camelCase 相容欄位。

gpt_description_prompt

string

描述模式提示詞相容欄位。

make_instrumental

boolean

預設值:false

是否生成純伴奏。

light_music

boolean

是否依輕音樂／背景音樂方向生成。

pure_music

boolean

是否按純音樂方向生成。

custom_mode

boolean

是否使用自訂模式。

customMode

boolean

custom_mode 的 camelCase 相容欄位。

title

string

歌曲標題。

回應

200 - application/json

code

string

成功時為 success。

範例:

"success"

message

string

錯誤或提示資訊。

data

object

任務 ID，用於後續查詢。

依 ID 查詢音樂任務