音效生成 API
介面說明
音效生成用於建立幾秒鐘的音效，不是一首歌。適合雷聲、雨點、撞擊聲這類短聲音，也可以做轉場音效、環境聲音和鼓點循環；多數在 5 秒以內，最長 20 秒左右，支援單次與循環兩種模式。
介面位址: POST /api/music/sounds
計費: 收費，目前預設 0.6 元/次。實際扣費以目前後台價格設定為準。
等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理並提交生成。實測多數請求 1–3 秒返回，約 10% 超過 30 秒，最長約 230 秒。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有生成，逾時後請勿立即重試（會重複下單、重複扣費）。 連線中斷可稍後用
GET /api/music/songs確認。詳見 Suno API 介面文件總覽的「等待時間與逾時設定」。
請求參數
Headers
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求主體參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| model | string | 否 | suno-v6 | 對客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| description | string | 是 | - | 描述你想要的聲音，用英文短句效果最穩，例如 cinematic whoosh transition, bright impact |
| title | string | 否 | - | 標題，不傳時可根據描述生成 |
| type | string | 否 | one_shot | 類型：one_shot（單次）、loop（循環） |
| loop | boolean | 否 | false | 是否循環，等價於把 type 寫成 loop |
| bpm | number | 否 | - | BPM，必須是大於 0 的數字；非法值返回 400（invalid_sound_bpm），不會靜默忽略 |
| key | string | 否 | - | 調式，格式為音名（C-B）+ 可選 #/b + 可選 Major/Minor，例如 C Major、C#m、Bb；空或 any 表示不限，非法值返回 400（invalid_sound_key） |
請求範例
curl -X POST https://www.suno-api.io/api/music/sounds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"description": "cinematic whoosh transition, bright impact",
"title": "cinematic whoosh",
"type": "one_shot",
"loop": false,
"bpm": 120,
"key": "C"
}'
回應結果
返回歌曲陣列，欄位同 Suno API 介面文件總覽 中的通用歌曲返回欄位。