跳转到主要内容
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": "e231****-****-****-****-****8cadc7dc"
}'
{
  "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
  }
}

使用指南

  • 使用此接口获取可与音频播放同步的歌词
  • 在音乐播放器中实现卡拉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
taskId
string
required

音乐生成任务的唯一标识符。应为"生成音乐"或"延长音乐"接口返回的taskId。

Example:

"5c79****be8e"

audioId
string
required

要获取歌词的特定音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。

Example:

"e231****-****-****-****-****8cadc7dc"

Response

请求成功

code
enum<integer>

响应状态码

  • 200: 成功 - 请求已成功处理
  • 401: 未授权 - 身份验证凭据缺失或无效
  • 402: 积分不足 - 账户没有足够的积分执行此操作
  • 404: 未找到 - 请求的资源或端点不存在
  • 409: 冲突 - WAV记录已存在
  • 422: 验证错误 - 请求参数未通过验证检查
  • 429: 超出限制 - 已超过对此资源的请求限制
  • 451: 未授权 - 获取图像失败。请验证您或您的服务提供商设置的任何访问限制。
  • 455: 服务不可用 - 系统当前正在进行维护
  • 500: 服务器错误 - 处理请求时发生意外错误
可用选项:
200,
401,
402,
404,
409,
422,
429,
451,
455,
500
msg
string

当 code != 200 时的错误信息

Example:

"success"

data
object