README.md

---
title: Music API
emoji: 🎵
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: mit
---

# 🎵 极简音乐 API

这是一个基于 FastAPI 的轻量级音乐流媒体服务，托管在 Hugging Face Spaces 上。

## 功能特性
- 🔍 **搜索**: 按歌名、艺术家搜索。
- 🎵 **播放**: 在线流媒体播放 MP3。
- 🖼️ **封面**: 支持自定义封面或自动生成默认封面。
- 📊 **统计**: 获取歌曲库统计信息。

## API 文档
访问 Space 首页即可查看详细的 API 文档，或访问 `/docs` 查看 Swagger UI。

## 如何添加音乐
目前版本数据库需要手动添加元数据。请使用 SQLite 客户端连接 `data/music.db` 并插入数据，或者联系管理员添加自动扫描脚本。