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-v6",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
'{
"code": "success",
"message": "",
"data": "task_xxx"
}建立音樂或聲音生成任務
音樂與聲音生成提交介面，相容舊 /suno/submit/music 路徑。返回任務 ID，後續透過 /suno/fetch/{task_id} 查詢。
音樂與聲音生成任務提交介面。透過 upstream_model 傳入子模型名稱。建立介面會返回 task_id，接著使用 /suno/fetch/{task_id} 查詢輸出。
未傳 upstream_model（或只傳 {"model":"suno_music"}）時，預設使用 Suno v5.5。需要繼續使用舊版 Suno 時，請明確傳入 "upstream_model":"suno-v5"。
可用子模型
| 類型 | upstream_model |
|---|---|
| 音樂 | suno-v6 |
| 音樂 | suno-v5.5 |
| 音樂 | suno-v5 |
| 音樂 | lyria-3-pro |
| 聲音 | seed-audio-1.0 |
| 聲音 | minimax-speech-2.8-hd |
提示詞描述模式
適合只描述風格、情緒、語言、歌手類型和場景，由模型自動生成歌曲內容。
{
"model": "suno_music",
"upstream_model": "suno-v6",
"prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
"make_instrumental": false
}
聲音生成
MiniMax Speech 可透過 extraParams 設定語音參數。
{
"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：
{
"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 提交歌詞。
{
"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-v6",
"prompt": "Create an energetic retro-pop DJ song about 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-v6 或 suno-v5.5；預設為 suno-v5.5。
"suno-v6"
MiniMax Speech 2.8 HD 的 voice、outputFormat、sampleRate、speed、volume、pitch 参数。
是否生成純伴奏。
是否依輕音樂／背景音樂方向生成。
是否按純音樂方向生成。
是否使用自訂模式。
歌曲標題。
風格標籤，例如 electro pop, female vocal。
歌詞內容。