拾音 开放 API v1

提供 歌曲/专辑搜索、128kbps 播放链接、歌词、专辑封面。公开调用，无需密钥，但按 IP 严格限流。

基本信息

⚠️ 明确限制：仅开放下列 5 个接口；音频固定 128kbps；封面为第三方图片直链；播放链接为临时签名地址（约 1 小时有效）。

⛔ 超限将返回 HTTP 917，并将该 IP 加入黑名单 6 小时，期间所有请求均返回 917。请勿高频轮询。

接口列表

GET歌曲搜索

GET /openapi?a=search&kw=起风了&page=1&limit=20
参数必填说明
kw是关键词
page否页码，默认 1
limit否每页数量，默认 20，最大 50
{
  "ok": true,
  "list": [
    { "id": "1330348068", "name": "起风了", "artist": "买辣椒也用券",
      "album": "起风了", "cover": "/openapi?a=pic&id=109951163699673355&size=300" }
  ]
}

GET专辑搜索

GET /openapi?a=album&kw=叶惠美&limit=20
{
  "ok": true,
  "list": [
    { "id": "372081313", "name": "叶惠美", "artist": "周杰伦",
      "cover": "http://p2.music.126.net/....jpg", "size": "18" }
  ]
}

GET播放链接（128kbps）

GET /openapi?a=url&id=1330348068
{
  "ok": true, "url": "https://m801.music.126.net/....mp3",
  "br": 128, "size": 5214920, "source": "netease", "expires_in": 3600
}

链接为临时签名地址，请及时使用或缓存；过期后重新请求。

GET歌词

GET /openapi?a=lyric&id=1330348068
{ "ok": true, "lyric": "[00:00.000] 作词 : 米果\n...", "tlyric": "" }

GET专辑封面

GET /openapi?a=pic&id=109951163699673355&size=300
{ "ok": true, "url": "https://p2.music.126.net/....jpg?param=300y300" }
参数必填说明
id是封面 id（搜索结果 cover 链接里已带）
size否尺寸，默认 500

状态码

HTTP含义
200成功
400参数缺失（如缺少 kw / id）
403调用了未开放的接口（仅允许 search/album/url/lyric/pic）
404无可用播放链接
917超过频率限制（同时该 IP 被拉黑 6 小时）

限制（务必遵守）