API 文档

请求参数

• source / provider：音源（见下方列表）
• platform：仅当 source=jianbin/jianbing/煎饼 时有效（netease/qq/kugou/kuwo）
• id / musicId：歌曲 ID（与 name 二选一，至少传一个）
• name / q：歌曲名（与 id 二选一，至少传一个）
• quality：期望音质（可选，部分音源可能忽略）
• key 或请求头 x-api-key：可选 API Key（用于绕过限流）

限流规则

• 默认按 IP 限流：每分钟最多 10-15 次（默认 12 次，可通过环境变量调整）。
• 携带正确的 MUSIC_API_KEY 可绕过限流。
• 如果服务端未配置 MUSIC_API_KEY，但请求传了 key，会返回“无法使用 key 调用”。

支持音源

别名支持：jianbin / jianbing / 煎饼。

调用示例

# 1) 按歌曲名（煎饼网易）
curl "http://localhost:3000/api/music?source=jianbin&platform=netease&name=稻香"

# 2) 按歌曲名 + 期望音质
curl "http://localhost:3000/api/music?source=qq&name=晴天&quality=320"

# 3) 按 ID + API key（query）
curl "http://localhost:3000/api/music?provider=qq&id=003aAYrm3GE0Ac&key=YOUR_KEY"

# 4) 按 ID + API key（header）
curl -H "x-api-key: YOUR_KEY" "http://localhost:3000/api/music?provider=qq&id=003aAYrm3GE0Ac"