音效生成

根据文本描述生成短音效。prompt 必填。

version：v6 / v6-wild / v6-mini，默认 v6。
建议尽量使用英文描述。
提交接口：POST /v1/music/generations，model: "suno-sounds"。
任务查询：GET /v1/music/generations/{task_id}。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。

In: header

Request Body

application/json

model*string

固定填写 suno-sounds。

version?string

公共版本：v6 / v6-wild / v6-mini；省略时默认 v6。

Default"v6"

Value in"v6" | "v6-wild" | "v6-mini"

prompt*string

音效文本描述，必填；缺失时提交期直接返回 400（不扣费）。官方建议优先使用英文以获得更佳效果。

type?string

音效类型：one-shot 为单次音效，loop 为可循环音效。

Default"one-shot"

Value in"one-shot" | "loop"

bpm?integer

音效速度，范围 1–300；超出范围时提交期直接返回 400（key param error）。

Range1 <= value <= 300

key?string

调性。支持 12 个大调（C、C#、D、D#、E、F、F#、G、G#、A、A#、B）及对应小调（后缀 m，如 Cm、C#m 等）。仅支持升号（#）写法，降号写法（Db、Eb 等）及 B# 会返回 400（key param error）。

Value in

"C" | "C#" | "D" | "D#" | "E" | "F" | "F#" | "G" | "G#" | "A" | "A#" | "B" | "Cm" | "C#m" | "Dm" | "D#m" | "Em" | "Fm" | "F#m" | "Gm" | "G#m" | "Am" | "A#m" | "Bm"

audio_format?string

输出音频格式：mp3 / m4a / wav。

Value in"mp3" | "m4a" | "wav"

Response Body

application/json

curl -X POST "https://loading/v1/music/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-sounds",
    "version": "v6",
    "prompt": "森林中由远及近的雷声和雨声",
    "type": "one-shot",
    "bpm": 90,
    "key": "Cm"
  }'

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-sounds",    "version": "v6",    "prompt": "森林中由远及近的雷声和雨声",    "type": "one-shot",    "bpm": 90,    "key": "Cm"  }'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
    }
  ]
}

{
  "code": "invalid_request",
  "message": "task_id is required",
  "data": null
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json