POST
/v2/timestamped-lyrics带时间戳的歌词 API
检索生成曲目的字级歌词时间戳、波形数据和对齐见解。
POST
https://udioapi.pro/api/v2/timestamped-lyricstips
生成完成后调用此端点以获取定时歌词。
提供audio_id和task_id。
requestHeaders
| name | required | description |
|---|---|---|
Authorization | yes | 用于身份验证的承载令牌 |
Content-Type | yes | application/json |
requestBody
提供两个标识符以进行比对查找
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
audio_id | string | yes | 来自提要或回调的音频资产 ID | fc490335-ad97-4444-ac64-0fb21c0d4308 |
task_id | string | yes | 由generate或extend返回的生成任务标识符 | gen2b9bb36e6c0cc44567aa34fbcff3afa64bksv |
responses
json
{
"code": 200,
"message": "success",
"data": {
"lyricAlignment": {
"words": [
{
"text": "[Verse]\nLola ",
"aligned": true,
"startTime": 0.55851,
"endTime": 0.87766,
"confidence": 0
},
{
"text": "Chouch, ",
"aligned": true,
"startTime": 0.91755,
"endTime": 1.91489,
"confidence": 0
}
]
},
"audioWaveform": [
0.00006,
0,
0.0339
],
"alignmentScore": 0.175,
"isStreaming": false
}
}codeExamples
curl
curl -X POST "https://udioapi.pro/api/v2/timestamped-lyrics" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"audio_id": "fc490335-ad97-4e08-ac64-0fb91c0d4308",
"task_id": "gen2b9bb36e6c0cc47969aa34fbcff3afa64bksv"
}'