获取带时间戳的歌词

POST

/api/v1/generate/get-timestamped-lyrics

获取音乐曲目的带精确时间戳的同步歌词。

使用指南

使用此接口获取可与音频播放同步的歌词

在音乐播放器中实现卡拉OK风格的歌词显示

创建与音频时间匹配的可视化效果

参数详情

需同时提供 taskId 和 audioId 以识别特定曲目

taskId 来自"生成音乐"，"延长音乐"，“上传并扩展” 和 ”上传并翻唱“ 接口

audioId 用于在生成多个版本时识别特定曲目

开发者注意事项

时间戳以秒为单位，用于精确同步

包含波形数据，可用于音频可视化实现

对于纯音乐曲目（使用 instrumental=true 创建），不会返回歌词数据

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

请求成功

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/generate/get-timestamped-lyrics' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "taskId": "5c79****be8e",
  "audioId": "e231****-****-****-****-****8cadc7dc"
}'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "alignedWords": [
            {
                "word": "[Verse]\nWaggin'",
                "success": true,
                "startS": 1.36,
                "endS": 1.79,
                "palign": 0
            }
        ],
        "waveformData": [
            0,
            1,
            0.5,
            0.75
        ],
        "hootCer": 0.3803191489361702,
        "isStreamed": false
    }
}

获取音乐任务详情

提升音乐风格

获取带时间戳的歌词

使用指南#

参数详情#

开发者注意事项#

Request

Responses

使用指南

参数详情

开发者注意事项