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.5",
"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} 查詢輸出。
未傳 upstream_model（或只傳 {"model":"suno_music"}）時，預設使用 Suno v5.5。需要繼續使用舊版 Suno 時，請明確傳入 "upstream_model":"suno-v5"。
新增模型
| 類型 | upstream_model / 別名 | modelId |
|---|---|---|
| 音樂 | suno-v5.5 / chirp-fenix | 128 |
| 聲音 | seed-audio-1.0 | 126 |
| 聲音 | minimax-speech-2.8-hd / speech-2.8-hd | 127 |
| 音樂 | lyria-3-pro / lyria-3-pro-preview | 129 |
提示詞描述模式
適合只描述風格、情緒、語言、歌手類型和場景，由模型自動生成歌曲內容。
{
"model": "suno_music",
"upstream_model": "suno-v5.5",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
聲音生成
MiniMax Speech 可透過 extraParams（或頂層同名 snake_case/camelCase 欄位）覆蓋語音參數。
{
"model": "suno_music",
"upstream_model": "minimax-speech-2.8-hd",
"prompt": "欢迎使用新版语音生成服务。",
"extraParams": {
"voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
"outputFormat": "mp3",
"sampleRate": 32000,
"speed": 1,
"volume": 1,
"pitch": 0
}
}
MiniMax Speech 未傳語音參數時，服務端預設發送上例中的 voice、outputFormat=mp3、sampleRate=32000、speed=1、volume=1 和 pitch=0。
Lyria 3 Pro 使用 upstream_model=lyria-3-pro（或 lyria-3-pro-preview）：
{
"model": "suno_music",
"upstream_model": "lyria-3-pro",
"prompt": "Cinematic orchestral music with a hopeful finale."
}
輕音樂或純伴奏
可使用 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} 查詢狀態、音訊位址、封面、標題、歌詞和上游回傳的原始片段資訊。
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.5",
"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"
}授權
使用 Bearer Token 認證。
格式: Authorization: Bearer sk-xxxxxx
主體
固定傳 suno_music。
suno_music "suno_music"
在提示詞描述模式下，作為音樂風格、情緒和場景；在歌詞高級模式下，可作為歌詞相容欄位。
生成引擎選擇值；預設為 suno-v5.5，顯式傳入 suno-v5 可保留舊版。
"suno-v5.5"
upstream_model 的相容別名。
upstream_model 的相容別名。
model_id 的 camelCase 相容欄位。
model_id 的 camelCase 相容欄位。
描述模式提示詞相容欄位。
MiniMax Speech 2.8 HD 的語音參數；是 extraParams 的 snake_case 相容欄位。
MiniMax Speech 2.8 HD 的語音參數；是 extraParams 的 snake_case 相容欄位。
MiniMax Speech 2.8 HD 音色，可覆蓋 extraParams.voice。
MiniMax Speech 2.8 HD 輸出格式。
output_format 的 camelCase 相容欄位。
MiniMax Speech 2.8 HD 取樣率。
sample_rate 的 camelCase 相容欄位。
語速，預設 1。
音量，預設為 1。
音調，預設為 0。
是否生成純伴奏。
是否依輕音樂／背景音樂方向生成。
是否按純音樂方向生成。
是否使用自訂模式。
custom_mode 的 camelCase 相容欄位。
歌曲標題。
風格標籤，例如 electro pop, female vocal。
風格相容欄位。
曲風相容欄位。
曲風相容欄位。
歌詞內容。
lyrics 相容別名。
lyrics 相容別名。
lyrics 相容別名。