Advanced Music Analysis & Audio Features API

A modern, advanced replacement for Spotify’s deprecated Audio Features API. Designed for developers and DJs, it provides deep audio features, rhythmic and harmonic analysis, and DJ-ready insights for over 256 million Spotify tracks.

原始信息汇总

Advanced Music Analysis & Audio Features API 数据集概述

数据集基本信息

• 数据集名称: Advanced Music Analysis & Audio Features API
• 类别: Music
• API版本: v1 (current)
• 数据源: Spotify
• 覆盖范围: 超过2.56亿首Spotify曲目

核心功能与定位

• 定位: Spotify已弃用的Audio Features API的现代化、高级替代品。
• 目标用户: 开发者和DJ。
• 核心功能: 提供深度音频特征、节奏与和声分析，以及适合DJ使用的洞察。

主要特性

音频特征

• Spotify风格音频特征（舞蹈性、能量、效价、响度、语音度等）。

节奏分析

• 高级节奏分析（速度、节拍、小节、乐句时长、拍号等）。

和声分析

• 为DJ设计的和声分析（调性、调式、用于和声混音的Camelot记谱法等）。

衍生分数

• 衍生的DJ与分析分数（舞池、热度、律动、可混音性、人声风险等）。

数据格式

• 干净、可预测、开发者友好的JSON格式，专为仪表板、DJ软件和数据管道设计。

设计特点

• 快速: 低延迟响应。
• DJ就绪: 乐句感知，兼容Camelot。
• 分析友好: 结构化、标准化的指标。
• 直接替代: 可作为已弃用Spotify端点的直接替代品。

核心用例

• DJ软件与表演工具: 节拍匹配、使用Camelot调性的和声混音、基于乐句的过渡、人声安全混音。
• 音乐分析与仪表板: 曲目比较、聚类、能量分析、情绪和强度分析。
• 推荐引擎: 能量感知播放列表、基于律动的排序、舞池优化。
• 音乐研究与数据科学: 对Spotify 2.56亿曲目目录进行大规模分析以获取趋势和洞察。

可用端点

获取曲目分析

• 端点: GET /v1/tracks/{spotify_track_id}/analysis
• 描述: 返回Spotify曲目的完整DJ就绪分析。

响应结构与字段参考

根字段

• spotify_track_id: 被分析曲目的Spotify ID（例如："4uLU6hMCjMI75M1A2tKUQC"）。

track 对象

• duration: 人类可读的时长（例如："6:52"）。
• duration_s: 以秒为单位的曲目时长，保留1位小数（例如：412.5）。
• duration_ms: 以毫秒为单位的曲目时长（例如：412531）。

rhythm 对象

• tempo: 格式化为文本的速度（例如："124.98 BPM"）。
• bpm: 以每分钟节拍数为单位的数字速度（例如：124.98）。
• bucket: 用于快速筛选的速度类别（例如："allegro", "presto"）。
• beats: 估计的总节拍数（例如：515）。
• beats_per_bar: 来自拍号的每小节节拍数（例如：4）。
• beat_duration_ms: 一个节拍的持续时间（毫秒）（例如：480）。
• bars: 估计的总小节数（例如：128）。
• time_signature: 音乐拍号（例如："4/4"）。
• half_time_bpm: 半速，适用于混音（例如：62.49）。
• double_time_bpm: 倍速，适用于混音（例如：249.96）。
• phrases_s: 基于小节的乐句持续时间（秒，始终保留1位小数）。
  • bar_1: 1小节的时长（例如：1.9）。
  • bar_2: 2小节的时长（例如：3.8）。
  • bar_4: 4小节的时长（例如：7.7）。
  • bar_8: 8小节的时长（例如：15.4）。
  • bar_16: 16小节的时长（例如：30.7）。
  • bar_32: 32小节的时长（例如：61.4）。
  • bar_64: 64小节的时长（例如：122.9）。
• phrases_count: 曲目中可用的完整乐句数量。
  • bar_16: 完整的16小节乐句数量（例如：8）。
  • bar_32: 完整的32小节乐句数量（例如：4）。

harmony 对象

• key: 音乐调性索引（0–11，例如：9）。
• mode: 音乐调式（"minor" / "major"）。
• camelot: Camelot记谱法（例如："8A"）。
• camelot_number: Camelot轮盘数字（例如：8）。
• camelot_letter: Camelot轮盘字母（"A" / "B"）。
• note: 音乐调性名称（例如："F#m"）。

features 对象

• danceability: 适合跳舞的程度（例如：0.81）。
• energy: 强度与活跃度（例如：0.87）。
• speechiness: 口语词汇的存在程度（例如：0.04）。
• acousticness: 曲目为原声乐器的可能性（例如：0.12）。
• instrumentalness: 曲目不含人声的可能性（例如：0.76）。
• liveness: 曲目为现场录制可能性（例如：0.09）。
• valence: 音乐积极性或情绪（例如：0.64）。
• loudness: 平均响度，格式化（例如："-6.8 dB"）。
• loudness_db: 平均响度，数字（例如：-6.823）。

derived 对象

• dance_floor_score: 适合高峰时段播放的程度（例如：0.82）。
• chill_score: 适合暖场或放松的程度（例如：0.31）。
• aggressive_score: 感知的硬度和强度（例如：0.74）。
• hype_score: 能量和兴奋潜力（例如：0.79）。
• groove_score: 律动一致性（例如：0.83）。
• warmup_score: 早期时段兼容性（例如：0.42）。
• peak_time_score: 高峰时段DJ适用性（例如：0.88）。
• blendability_score: 与其他曲目混音的难易度（例如：0.71）。
• vocal_risk_score: 过渡期间人声冲突的风险（例如：0.18）。

flags 对象

• is_vocal_heavy: 曲目包含显著人声（true / false）。
• is_acoustic: 曲目主要为原声（true / false）。
• is_instrumental: 曲目主要为器乐（true / false）。
• is_live_recording: 曲目可能为现场录制（true / false）。
• is_club_loud: 曲目响度足以用于俱乐部环境（true / false）。

认证与访问

• 该API专门通过RapidAPI提供。
• 认证和速率限制自动处理。

从Spotify Audio Features迁移

• 原端点: GET /audio-features/{id} 或 GET /audio-analysis/{id}
• 迁移至: GET /v1/tracks/{spotify_track_id}/analysis
• 此端点涵盖所有基本功能，并增加了DJ特定的增强功能。