接入文档

三步：登录控制台 → 创建 mk_… Key → 调接口或嵌 iframe。默认每日 1000 次（UTC 日切）。

Key 只属于 Mochi：形如 mk_…，用来鉴权与计额度。不是网易云 AppId / AppSecret。本站首页试听不用 Key；嵌到你自己的网站才需要。详见服务条款。

API 在线测试

粘贴你保存的 Key，选接口点发送。示例 Key 请用控制台自己的，勿把生产 Key 发给他人。

接口 API Key 参数

响应会显示在这里…

1. 鉴权

Header：Authorization: Bearer mk_你的密钥
Query：?key=mk_你的密钥（iframe 推荐）
明文 Key 仅创建时复制一次，请自行保存；列表只显示前缀。

2. 歌曲元数据

GET /api/v1/song.php?id={歌曲ID}&key={API_KEY}

curl "https://music.aikex.ink/api/v1/song.php?id=2618165651&key=mk_你的密钥"

成功 code=1，含 name / artists / cover / outer_url / usage。

3. 歌单

GET /api/v1/playlist.php?id={歌单ID}&key={API_KEY}&limit=50&probe=0

curl "https://music.aikex.ink/api/v1/playlist.php?id=3778678&key=mk_你的密钥&probe=0"

一次消耗 1 次额度；probe=0 秒开，播放器后台跳过 VIP。
探测：GET /api/v1/probe.php?ids=a,b&key=…（不扣额度）。

4. 用量

curl "https://music.aikex.ink/api/v1/me.php?key=mk_你的密钥"

5. 错误码

HTTP	说明
200 + code=1	成功
200 + code=0	业务失败
401	无效 API Key
429	今日额度用尽

6. 嵌入播放器

推荐在个人中心 → 嵌入选用密钥一键生成（链接用 et= 嵌入令牌，无需粘贴明文 Key）。仍可用 key=mk_…。

<iframe
  src="https://music.aikex.ink/embed.html?id=2618165651&key=mk_你的密钥&theme=peach"
  width="360" height="140"
  frameborder="0" allow="autoplay"
  style="border-radius:20px;border:0"></iframe>

<iframe
  src="https://music.aikex.ink/embed.html?playlist=3778678&key=mk_你的密钥&theme=peach"
  width="420" height="168"
  frameborder="0" allow="autoplay"
  style="border-radius:20px;border:0"></iframe>

7. 能力边界

公开可外链曲目；VIP/版权自动跳过，不解锁。
接入方对最终站点版权合规负责。

打开控制台 · API 测试 · 返回首页