API Docs

认证：所有 /api/*、/v1/* 接口都要带请求头 x-api-key: <key>（或 Authorization: Bearer <key>）。

账号池：可用请求头 X-Suno-Account 指定账号；不指定时，生成类接口自动选积分最多的账号，针对某首歌的接口自动用这首歌所属的账号。

典型流程：

POST /api/custom_generate（wait_audio: false）→ 返回 2 首歌的 ID
每 5–10 秒 GET /api/get?ids=<id1>,<id2>，直到 status 为 complete
用 audio_url 在线播放，或 GET /api/download?id=<id>&format=wav 拿下载链接

curl -X POST https://sn.tbrw.com/api/custom_generate \
  -H "x-api-key: <API_KEY>" -H "Content-Type: application/json" \
  -d '{"prompt":"[Verse]\n...","tags":"pop, female vocals","title":"夏夜海边"}'

下方可查看全部接口参数；点 Authorize 填入 API Key 后可直接在本页调试（生成类接口会消耗真实积分）。

API Docs

接口详情与在线调试