理解歌曲

对输入的歌曲作理解描述，分析其配器、曲风、标签和总体特征。

接口信息

• 方法: POST
• 路径: /api/v1/music?action=song_describe

认证

BearerAuth Type: HTTP (bearer)

请求体

{
  "url": "string"
}

参数说明

字段	类型	必填	说明
url	string	是	音频文件 ID 或 URL，支持格式：mp3，m4a。也支持 base64 格式的 URL，最大数据大小为 10MB。

响应示例

{
  "code": 0,
  "message": "success",
  "resp_data": {
    "instrument": ["piano", "guitar", "drums", "bass"],
    "genres": ["pop", "ballad"],
    "tags": ["emotional", "melodic", "acoustic"],
    "description": "这是一首充满情感的流行民谣，以钢琴和吉他为主要配器，旋律优美动人，适合表达青春与梦想的主题。"
  }
}

响应字段说明

• instrument: 字符串数组，歌曲使用的配器列表。
• genres: 字符串数组，歌曲的曲风列表。
• tags: 字符串数组，歌曲的标签列表。
• description: 字符串，歌曲的总体描述。

请求示例

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"
  }'