API 엔드포인트

타임스탬프 가사

POST/v2/timestamped-lyrics

타임스탬프 가사 API

생성된 트랙에 대한 단어 수준 가사 타임스탬프, 파형 데이터 및 정렬 통찰력을 검색합니다.

POSThttps://udioapi.pro/api/v2/timestamped-lyrics

tips

생성 완료 후 이 엔드포인트를 호출하여 시간이 지정된 가사를 가져옵니다.

audio_idtask_id를 제공하세요.

requestHeaders

namerequireddescription
Authorizationyes인증을 위한 Bearer 토큰
Content-Typeyesapplication/json

requestBody

정렬 조회를 위해 두 식별자를 모두 제공하세요.

commonParams

paramNameparamTyperequireddescriptionexample
audio_idstringyes피드 또는 콜백의 오디오 자산 IDfc490335-ad97-4444-ac64-0fb21c0d4308
task_idstringyes생성 또는 확장에 의해 반환된 생성 작업 식별자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
  }
}
json
{
  "code": 401,
  "message": "Missing or invalid Authorization header. Use 'Bearer YOUR_API_KEY'",
  "data": null
}
json
{
  "code": 400,
  "message": "Task ID and Audio ID are required, please provide both task_id and audio_id in the request body",
  "data": null
}
json
{
  "code": 400,
  "message": "Invalid task id",
  "data": null
}
json
{
  "code": 400,
  "message": "Your request is being processed. Please wait until it completes.",
  "status": "IN_PROGRESS",
  "data": null
}
json
{
  "code": 400,
  "message": "Audio ID does not match the Task ID, please check and try again",
  "data": null
}
json
{
  "code": 500,
  "message": "Internal Server Error, please try again later",
  "data": null
}

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"
  }'
javascript
const response = await $fetch("https://udioapi.pro/api/v2/timestamped-lyrics", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: {
    audio_id: "fc490335-ad97-4e08-ac64-0fb91c0d4308",
    task_id: "gen2b9bb36e6c0cc47969aa34fbcff3afa64bksv",
  },
});

const { data } = response;
const lyricWords = data.lyricAlignment.words;
const waveform = data.audioWaveform;