{ "ok": true, "id": "6", "name": "随机歌曲", "description": "随机一首歌，不定时更新列表", "method": "GET/POST", "endpoint": "https://api.mangox.asia/api/music/", "example": "https://api.mangox.asia/api/music/?token=您的密钥", "status": "ok", "free": true, "parameters": [ { "name": "token", "type": "string", "required": true, "desc": "登录获取的用户密钥，必须为10位大写字母或数字" }, { "name": "tz", "type": "string", "required": false, "desc": "时区，支持 IANA 名（Asia/Shanghai）、UTC、UTC+8、+08:00、GMT-5:30，默认 UTC" }, { "name": "ts", "type": "int", "required": false, "desc": "Unix 时间戳（秒），可为负数，默认当前时间；与 utc 同时传时 utc 优先" }, { "name": "utc", "type": "string", "required": false, "desc": "UTC 日期时间，格式 YYYY-MM-DD HH:MM:SS，范围 1800-01-01 00:00:00 ~ 2200-12-31 23:59:59" }, { "name": "format", "type": "string", "required": false, "desc": "返回类型，text（默认）或 json" }, { "name": "提示：", "type": "提示", "required": false, "desc": "本接口每分钟限制30次请求" } ], "required_count": 1, "response": "{\n \"code\": 200,\n \"data\": {\n \"basic_info\": {\n \"id\": \"\",\n \"title\": \"神のまにまに\",\n \"artist\": \"初音ミク/鏡音リン\",\n \"album\": \"聖槍爆裂ボーイ\",\n \"duration\": \"00:00\"\n },\n \"media\": {\n \"cover_image\": \"https://p3.music.126.net/ze4CaBh_BTQrtBzbhYTI3A==/7886796906969685.jpg?param=800y800\",\n \"audio_url\": \"https://m801.music.126.net/20261004120446/34d7b9af7173ee1b24bdc1ea61e16042/jdymusic/obj/wo3DlMOGwrbDjj7DisKw/7952942319/19ad/fa95/9459/2ba8af744ae20a41b18189a3110e052b.mp3?vuutv=eUPm/NyEjq9hWQAnz+N4amE7E+VJPGGHZCQNBw/3THLJ0z1cUUUEO8e7SvylR4Vu/oOLna19MqApWi03eJwa8SB7rJRfGH7ZBk8R+N2+fmU=\",\n \"audio_quality\": \"未知\",\n \"file_size\": \"未知\"\n },\n \"lyrics\": \"[00:00.00] 「MGO-API」声明：本歌曲及其内容仅供学习参考，禁止商用。\\n[00:00.10] 制作人 : れるりり\\n[00:00.05] 作词 : れるりり\\n[00:00.11] 作曲 : れるりり\\n[00:00.16] 编曲 : れるりり\\n[00:00.22]神のまにまに - 初音未来\\n[00:05.00]\\n[00:23.26]思い通りに いかないことだらけ\\n[00:27.09]どうしようもなく 自己嫌悪\\n[00:30.28]八百万の 痛みや悲しみから\\n[00:33.75]逃げ込める場所を\\n[00:35.89]探してる\\n[00:37.29]いっそ 岩の隙間に引きこもって\\n[00:40.75]月も太陽も無視して 眠ろう\\n[00:44.46]生まれてきたことの 意味なんて\\n[00:47.98]知らない 分かんないよ\\n[00:51.53]でも そんな風に 思えるってこと\\n[00:56.90]それは 君がもっともっと素敵に なれる力が\\n[01:02.72]あるって 教えてるんだよ\\n[01:07.79]\\n[01:08.67]そうさ\\n[01:09.94]神の まにまに\\n[01:11.66]仰せの ままに\\n[01:13.46]誰だって 地球を愛してる\\n[01:17.17]飲めや 歌えや\\n[01:18.83]どんちゃん 騒ぎ\\n[01:20.60]たまにゃ そんなのも\\n[01:22.39]いいね\\n[01:23.50]そうさ 北も南も\\n[01:25.92]右も 左も\\n[01:27.66]なんだかんだ 地球を愛してる\\n[01:31.27]泥んこ だけど\\n[01:33.03]歩いて 行ける\\n[01:34.79]まだまだ 先は長いさ\\n[01:38.32]\\n[01:39.59]ただ 正しい人でいたいだけ\\n[01:43.08]きっと誰もが そう願っているけど\\n[01:46.66]八百万の心の醜さに\\n[01:50.24]苦しめられる毎日さ\\n[01:53.79]僕が生まれてきたこと\\n[01:57.33]奇跡と言えば 聞こえはいいけど\\n[02:00.79]それはきっと 偶然にすぎなくて\\n[02:04.37]やっぱり 意味なんて ないさ\\n[02:08.05]でも 例えば君に いじわるを するやつが\\n[02:15.17]いるなら それは君がとっても\\n[02:17.93]素敵な人だって\\n[02:20.81]教えてるんだよ\\n[02:24.14]\\n[02:25.07]そうさ\\n[02:26.40]神の まにまに\\n[02:28.10]仰せの ままに\\n[02:29.91]誰だって 地球を愛してる\\n[02:33.55]僕が 笑って\\n[02:35.24]君も 笑えば\\n[02:36.97]許せないことなんてないよ\\n[02:39.96]そうさ 男も女も\\n[02:42.34]恋しかるべき\\n[02:44.16]そんなふうに 地球は回ってる\\n[02:47.81]どろんこだけど 歩いていこう\\n[02:51.23]まだまだ先は長いさ\\n[02:54.51]本当に大事な ものなんて\\n[02:57.73]案外 くだらないことの 中にあるよ\\n[03:02.14]ときにはみんなで 馬鹿騒ぎ\\n[03:04.74]裸踊りで 大笑い\\n[03:10.57]\\n[03:11.32]そうさ\\n[03:12.63]神のまにまに 仰せのままに\\n[03:16.13]もっともっと自分を 愛せるよ\\n[03:19.30]鏡を見てご覧よ もう分かるでしょ\\n[03:23.30]みんなを照らす光さ\\n[03:26.15]そうさ\\n[03:26.87]神のまにまに\\n[03:28.55]みんなありがとう\\n[03:30.44]やっぱり地球を愛してる\\n[03:33.95]花を咲かそう\\n[03:35.70]大きな花を\\n[03:37.49]天まで届くくらいの!\\n[03:40.40]la la la la la la la la la la\\n[03:42.81]la la la la la la la\\n[03:44.57]la la la la la la la la la la la la la\\n[03:48.18]la la la la la la la\\n[03:49.88]la la la la la la la\\n[03:51.68]la la la la la la la la la\\n[03:54.62]la la la la la la la la la la\\n[03:57.00]la la la la la la la\\n[03:58.83]la la la la la la la la la la la la la\\n[04:02.38]la la la la la la la\\n[04:04.15]la la la la la la la\\n[04:05.95]la la la la la la la la la\\n[04:09.59]\\n\",\n \"platform\": {\n \"source\": \"网易云音乐\",\n \"type\": \"wy\",\n \"pic_id\": \"7886796906969685\"\n },\n \"selected_index\": 1\n }\n}", "status_codes": [ { "code": "200", "message": "解析成功" }, { "code": "400", "message": "参数错误" }, { "code": "403", "message": "无效密钥" }, { "code": "404", "message": "源站缺失" }, { "code": "408", "message": "请求超时" }, { "code": "410", "message": "解析失败" }, { "code": "422", "message": "解析错误" } ], "faqs": [ { "q": "如何调用 随机歌曲 接口？", "a": "使用 GET/POST 方式请求 https://api.mangox.asia/api/music/，按需携带「请求参数」中的字段即可获取返回数据。若接口需要密钥，请在本页「快速开始」处点击「填充 Token」，输入后示例地址与代码中的「您的密钥」会自动替换为你的 token，直接复制即可使用。" }, { "q": "随机歌曲 接口支持哪些请求方式？", "a": "目前支持 GET/POST 请求方式，请求地址为 https://api.mangox.asia/api/music/。接口同时兼容 cURL、Python requests、Java HttpClient、JavaScript fetch 等常见客户端。" }, { "q": "随机歌曲 接口是免费的吗？", "a": "是的，该接口由 MGO-API 免费开放，无需付费即可调用，也不限制调用次数（合理使用即可）。" }, { "q": "调用 随机歌曲 接口返回错误怎么办？", "a": "请对照「状态码说明」排查：400 参数错误（检查参数名与类型）、403 无效密钥（检查 token 是否正确）、404 源站缺失（源站资源不存在）、408 请求超时（稍后重试或降低并发）、410 解析失败（源站内容已失效）、422 解析错误（源站返回格式异常）。若持续报错，可联系站长协助处理。" }, { "q": "接口提示「无效密钥 / 403」该如何处理？", "a": "请确认 token 参数是否正确、是否已过期。可在本页「快速开始」中点击「填充 Token」，输入你的密钥后，示例地址与代码里所有「您的密钥」占位内容都会自动替换，直接复制即可使用。" }, { "q": "接口响应很慢或者超时（408）怎么办？", "a": "可先重试一次；若仍超时，可能是源站临时波动。建议客户端设置 10 秒以上超时，并避免高频并发请求，稍后再试通常即可恢复。" }, { "q": "如何导出这份接口文档？", "a": "在页面顶部点击「导出文档」按钮，在弹出的窗口中选择 Markdown（.md）、Word（.doc）或纯文本（.txt）格式，导出文件会附带站点域名、原文档地址与导出时间，方便离线查阅或写进项目文档。也可以在地址后追加 &format=json 获取结构化 JSON，或追加 &format=md 获取 Markdown 纯文本，便于 AI 与程序抓取。" }, { "q": "遇到问题如何联系站长？", "a": "节假日白天可联系站长 QQ：2201040041（其他时段留言即可，看到会尽快回复）。" } ], "keywords": [ "随机歌曲", "随机歌曲接口", "随机歌曲API", "随机歌曲接口文档", "随机歌曲怎么调用", "MGO-API", "免费API", "API接口", "接口文档", "GET/POST接口" ], "doc_url": "https://api.mangox.asia/doc?id=6", "json_url": "https://api.mangox.asia/doc?id=6&format=json", "markdown_url": "https://api.mangox.asia/doc?id=6&format=md", "provider": { "name": "MGO-API", "url": "https://api.mangox.asia/" } }