Recognize Song

Convert input songs to lyrics with timestamp information.

API Information

• Method: POST
• Endpoint: /api/v1/music?action=song_recognize
• Function: Recognize song

Authentication

BearerAuth Type: HTTP (bearer)

Request Body

{
  "upload_audio_id": "string"
}

Parameter Description

Field	Type	Required	Description
upload_audio_id	string	Yes	Upload ID of the song to recognize, generated by files/upload API (purpose: audio)

Response

{
  "code": 0,
  "message": "success",
  "resp_data": {
    "duration": 240000,
    "lyrics_sections": [
      {
        "section_type": "verse",
        "start": 0,
        "end": 30000,
        "lines": [
          {
            "start": 0,
            "end": 15000,
            "text": "Youth blooms like flowers",
            "words": [
              {
                "start": 0,
                "end": 5000,
                "text": "Youth"
              },
              {
                "start": 5000,
                "end": 10000,
                "text": "blooms"
              },
              {
                "start": 10000,
                "end": 15000,
                "text": "like flowers"
              }
            ]
          }
        ]
      }
    ]
  }
}

Request Example

curl -X POST "[HOST]/api/v1/music?action=song_recognize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_audio_id": "file_1234567890abcdef"
  }'