汽水音乐开放平台为开发者提供音乐推荐API、音频分析SDK、播放器组件等全套技术工具。将抖音量级的AI推荐能力接入你的应用，让音乐体验升级。
$ npm install @qishui/sdk Read the Docs →RESTful API · JSON Response · Rate Limit 1000 req/min
基于用户画像和上下文信息的智能音乐推荐接口。返回个性化歌曲列表，支持按心情、场景、BPM等多维度筛选。
上传音频文件或提供URL，返回BPM、节拍类型、律动模式、能量曲线等全面节奏分析数据。
支持歌名、歌手、专辑、歌词等维度的全库搜索。模糊匹配+语义理解的混合搜索引擎。
获取LRC逐行动态歌词、逐字歌词和罗马音标注。支持原文+翻译的同步返回。
获取授权用户的音乐偏好画像，包括喜欢的流派、BPM区间、音色偏好等多维度标签。
根据种子歌曲或文字描述，AI自动生成符合主题的智能歌单。支持指定曲目数量、风格约束等参数。
三行代码接入AI音乐推荐
import { QishuiClient } from '@qishui/sdk';
const client = new QishuiClient({ apiKey: 'YOUR_API_KEY' });
const songs = await client.recommend({
userId: 'user_12345',
mood: 'energetic',
bpm: { min: 120, max: 150 },
limit: 20
});
// → 返回20首匹配运动场景的高能歌曲from qishui import QishuiClient
client = QishuiClient(api_key="YOUR_API_KEY")
analysis = client.analyze_audio(
audio_url="https://example.com/song.mp3"
)
# → { bpm: 128, key: "Am", energy: 0.85, ... }
print(f"BPM: {analysis.bpm}, Key: {analysis.key}")从零开始接入汽水音乐API，涵盖账号注册、API Key申请、基础概念和第一个API调用。
完整的API端点文档，包括请求参数、响应格式、错误码和调用示例。
各语言SDK的详细使用指南，覆盖认证、请求构建、错误处理和高级特性。
API调用最佳实践：缓存策略、速率限制处理、批量请求优化和安全注意事项。
开发者常见问题