MeloData

Music audio features API — get BPM, key, energy, danceability, valence, and more for any track by ISRC. Built as a replacement for Spotify's deprecated audio features endpoints.

原始信息汇总

MeloData 数据集概述

数据集名称

MeloData

数据集提供方

Voltenworks

数据集类别

音乐

数据集描述

MeloData 是一个音乐音频特征 API，可提供任意曲目的 BPM、调性、能量感、可舞性、情绪效价等特征。该 API 是作为 Spotify 已弃用的音频特征端点的替代品而构建的。

核心功能

• 通过 ISRC 获取曲目的音频特征。
• 提供数百万首预先分析的曲目以供即时查询。
• 包含搜索曲目、获取元数据、批量查找、艺术家信息、推荐和健康检查等功能。

主要端点

方法	端点	描述
GET	/tracks/{isrc}/features	获取曲目的音频特征
GET	/tracks/search?q=	按名称或艺术家搜索曲目
GET	/tracks/{isrc}/metadata	获取曲目元数据（标题、艺术家、专辑、流派）
POST	/tracks/batch/features	批量查找最多 50 首曲目
POST	/tracks/batch/analyze	免费预分析曲目
GET	/artists/{id}	获取艺术家信息
GET	/recommendations	根据音频特征查找相似曲目
GET	/health	API 状态检查

音频特征说明

特征	范围	描述
bpm	0–300+	每分钟节拍数（速度）
key	A–G#	音乐调性（例如 "Bb", "C#m"）
energy	0.0–1.0	感知强度和活跃度
danceability	0.0–1.0	适合跳舞的程度
valence	0.0–1.0	音乐积极性（快乐 vs 悲伤）
acousticness	0.0–1.0	曲目是否为原声
loudness	dB	整体响度
instrumentalness	0.0–1.0	曲目是否包含人声
speechiness	0.0–1.0	口语单词的存在
liveness	0.0–1.0	现场观众的存在

使用场景

• 播放列表生成器 — 按 BPM、能量感或情绪进行过滤和排序。
• DJ 工具 — 根据调性和速度匹配曲目以实现平滑过渡。
• 健身应用 — 根据跑步、骑行、举重等运动的 BPM 自动生成播放列表。
• 基于情绪的电台 — 结合能量感和情绪效价创建快乐、悲伤、放松或兴奋的电台。
• 音乐教育 — 分析调性、拍号和速度以用于学习工具。
• 智能随机播放 — 按能量流而非随机顺序排列歌曲。
• 歌曲推荐 — 基于音频特征向量查找相似曲目。

工作原理

1. 若请求的曲目尚未被分析，API 将返回 202 Accepted 及 Retry-After: 30。
2. 分析管道将处理该曲目（约 30 秒）。
3. 下一次请求将立即返回缓存的结果。
4. 202 响应不计费 — 仅对成功的查找收费。
5. 曲目一旦被分析，将被永久缓存。数据库随着每次请求而增长。

计费规则

• 失败的请求（5xx 服务器错误）不计费。
• 被限速的请求（429）不计费。
• 分析中的响应（202）不计费。
• 客户端错误（4xx）和成功的响应（2xx）会计费。

订阅计划

计划	价格	每月查找次数	速率限制
Free	$0	1,000	5 次请求/秒
Dev	$19/月	25,000	10 次请求/秒
Pro	$79/月	200,000	25 次请求/秒
Scale	$299/月	1,000,000	50 次请求/秒
超出计划限制的额外查找费用： $0.002 每次。

相关链接

• 文档
• 仪表板 & API 密钥
• 定价
• 使用条款
• 博客：Why We Built MeloData