KIE.AI
Chinese
  • English
  • Chinese
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation
  • Suno API 快速开始
  • Music Generation
    • 生成音乐回调
    • 音乐扩展回调
    • 音频上传和翻唱回调
    • 音频上传和扩展回调
    • 添加伴奏回调
    • 添加人声回调
    • 音乐封面生成回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏生成音乐
      POST
    • 添加人声生成音乐
      POST
    • 获取音乐任务详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 替换音乐分区
      POST
    • 生成音乐封面
      POST
    • 获取音乐封面生成详情
      GET
    • 生成 Persona
      POST
  • Lyrics Generation
    • 生成歌词回调
    • 生成歌词
      POST
    • 获取歌词任务详情
      GET
  • WAV Conversion
    • 转换为WAV格式回调
    • 转换为WAV格式
      POST
    • 获取WAV转换详情
      GET
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
    • 人声和乐器分离
    • 获取人声和乐器分离详情
  • Music Video Generation
    • MP4生成完成回调
    • 创建音乐视频
    • 获取音乐视频详情
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation

获取带时间戳的歌词

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 ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
请求成功
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/generate/get-timestamped-lyrics' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "5c79****be8e",
    "audioId": "e231****-****-****-****-****8cadc7dc"
}'
Response Response Example
200 - 成功示例
{
    "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
    }
}
Previous
获取音乐任务详情
Next
提升音乐风格
Built with