POST
/
api
/
v1
/
generate
/
get-timestamped-lyrics
获取带时间戳的歌词
curl --request POST \
  --url https://api.kie.ai/api/v1/generate/get-timestamped-lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "taskId": "5c79****be8e",
  "audioId": "8551****662c"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "alignedWords": [
      {
        "word": "[Verse]\nWaggin'",
        "success": true,
        "start_s": 1.36,
        "end_s": 1.79,
        "p_align": 0
      }
    ],
    "waveformData": [
      0,
      1,
      0.5,
      0.75
    ],
    "hootCer": 0.3803191489361702,
    "isStreamed": false
  }
}

使用指南

  • 使用此接口获取可与音频播放同步的歌词
  • 在音乐播放器中实现卡拉OK风格的歌词显示
  • 创建与音频时间匹配的可视化效果

参数详情

  • 需同时提供 taskIdaudioId 以识别特定曲目
  • taskId 来自”生成音乐”或”延长音乐”接口
  • audioId 用于在生成多个版本时识别特定曲目

开发者注意事项

  • 时间戳以秒为单位,用于精确同步
  • 包含波形数据,可用于音频可视化实现
  • 对于纯音乐曲目(使用 instrumental=true 创建),不会返回歌词数据

Authorizations

Authorization
string
header
required

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY

注意事项:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.