时间轴歌词 API
接口说明
时间轴歌词用于获取歌曲逐词级别的时间戳，可用于歌词同步显示。
接口地址: POST /api/lyrics/timeline
计费: 免费。
请求参数
Headers
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
Body 参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 否 | suno-v6 | 对客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| song_id | string | 是 | - | 歌曲 ID |
请求示例
curl -X POST https://www.suno-api.io/api/lyrics/timeline \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "clip_id"
}'
响应结果
[
{
"word": "hello",
"start_s": 0.12,
"end_s": 0.45,
"success": true,
"p_align": 0.99
}
]
兼容说明
旧版文档中曾使用 { success, song_id, lyrics: [...] } 包装对象示例。当前新版文档以直接返回时间轴数组为准。