Describe Song

Provide descriptive understanding of an input song, analyzing its instrumentation, music style, tags, and overall characteristics.

API Information

• Method: POST
• Endpoint: /api/v1/music?action=song_describe

Authentication

BearerAuth Type: HTTP (bearer)

Request Body

{
  "url": "string"
}

Parameter Description

Field	Type	Required	Description
url	string	Yes	Audio file ID or URL, supported formats: mp3, m4a. Also supports base64 format URL, maximum data size 10MB.

Response Example

{
  "code": 0,
  "message": "success",
  "resp_data": {
    "instrument": ["piano", "guitar", "drums", "bass"],
    "genres": ["pop", "ballad"],
    "tags": ["emotional", "melodic", "acoustic"],
    "description": "This is an emotional pop ballad, with piano and guitar as the main instrumentation, featuring a beautiful and moving melody, suitable for expressing themes of youth and dreams."
  }
}

Response Field Description

• instrument: Array of strings, list of instrumentation used in the song.
• genres: Array of strings, list of music genres of the song.
• tags: Array of strings, list of tags for the song.
• description: String, overall description of the song.

Request Example

curl -X POST "[HOST]/api/v1/music?action=song_describe" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/audio/song_1234567890abcdef.mp3"
  }'