Meting-API-使用指南

Meting-API-使用指南

2026年7月26日·#技术分享宝塔面板/音乐/指南·1192 字 6 分钟
浏览量加载中...
AI 摘要

介绍如何使用Meting-API

多平台音乐 API 代理服务，支持网易云、QQ音乐、酷狗、百度、酷我。

基础信息#

项目说明
API 地址https://你的域名/api
请求方式GET
响应格式JSON / 重定向 / 纯文本
鉴权方式HMAC-SHA1 Token

支持的平台#

平台server 参数说明
网易云音乐netease功能完整
QQ音乐tencent功能完整
酷狗音乐kugou功能完整
百度音乐baidu功能完整
酷我音乐kuwo功能完整

API 接口#

请求参数#

参数类型必填说明
serverstring是音乐平台
typestring是操作类型
idstring是资源 ID 或搜索关键词
authstring条件鉴权令牌（敏感操作需要）

操作类型#

type说明需要鉴权返回格式
search搜索歌曲❌JSON 数组
song获取歌曲详情❌JSON 数组
album获取专辑❌JSON 数组
artist获取歌手作品❌JSON 数组
playlist获取歌单❌JSON 数组
lrc获取歌词✅LRC 纯文本
url获取播放链接✅302 重定向
pic获取封面图片✅302 重定向

使用示例#

1. 搜索歌曲#

Terminal window
# 网易云搜索
curl "https://你的域名/api?server=netease&type=search&id=周杰伦"


# QQ音乐搜索
curl "https://你的域名/api?server=tencent&type=search&id=周杰伦"


# 酷狗搜索
curl "https://你的域名/api?server=kugou&type=search&id=稻香"

响应示例：

[
  {
    "title": "稻香",
    "author": "周杰伦",
    "url": "https://你的域名/api?server=netease&type=url&id=185790&auth=xxx",
    "pic": "https://你的域名/api?server=netease&type=pic&id=109951171358446171&auth=xxx",
    "lrc": "https://你的域名/api?server=netease&type=lrc&id=185790&auth=xxx"
  }
]

2. 获取歌词#

Terminal window
curl "https://你的域名/api?server=netease&type=lrc&id=185790&auth=你的token"

响应示例（LRC 格式）：

[00:00.000] 稻香 - 周杰伦
[00:01.000] 词：周杰伦
[00:02.000] 曲：周杰伦
[00:18.500] 对这个世界如果你有太多的抱怨
[00:21.500] 跌倒了就不敢继续往前走

3. 获取播放链接#

Terminal window
curl -L "https://你的域名/api?server=netease&type=url&id=185790&auth=你的token"

说明： 会返回 302 重定向到实际音乐文件地址。

4. 获取封面图片#

Terminal window
curl -L "https://你的域名/api?server=netease&type=pic&id=109951171358446171&auth=你的token"

说明： 会返回 302 重定向到实际图片地址。

5. 获取歌单#

Terminal window
curl "https://你的域名/api?server=netease&type=playlist&id=24381616"

6. 获取专辑#

Terminal window
curl "https://你的域名/api?server=netease&type=album&id=34819136"

7. 获取歌手作品#

Terminal window
curl "https://你的域名/api?server=netease&type=artist&id=6452"

Token 计算方法#

敏感操作（lrc、url、pic）需要提供鉴权 Token。

计算公式#

token = HMAC-SHA1(secret, server + type + id)

JavaScript 示例#

const crypto = require('crypto');


function generateToken(server, type, id, secret = '你的密钥') {
  const message = `${server}${type}${id}`;
  return crypto.createHmac('sha1', secret).update(message).digest('hex');
}


// 示例
const token = generateToken('netease', 'url', '185790');
console.log(token);

Python 示例#

import hmac
import hashlib


def generate_token(server, type, id, secret='你的密钥'):
    message = f'{server}{type}{id}'
    return hmac.new(secret.encode(), message.encode(), hashlib.sha1).hexdigest()


# 示例
token = generate_token('netease', 'url', '185790')
print(token)

PHP 示例#

<?php
function generateToken($server, $type, $id, $secret = '你的密钥') {
    $message = $server . $type . $id;
    return hash_hmac('sha1', $message, $secret);
}


// 示例
$token = generateToken('netease', 'url', '185790');
echo $token;
?>

前端集成示例#

HTML Audio 播放器#

<!DOCTYPE html>
<html>
<head>
    <title>音乐播放器</title>
</head>
<body>
    <input type="text" id="keyword" placeholder="搜索歌曲">
    <button onclick="search()">搜索</button>
    <div id="results"></div>
    <audio id="player" controls></audio>


    <script>
        const API = 'https://你的域名/api';


        async function search() {
            const keyword = document.getElementById('keyword').value;
            const res = await fetch(`${API}?server=netease&type=search&id=${keyword}`);
            const songs = await res.json();


            const html = songs.map((song, i) => `
                <div onclick="play('${song.url}', '${song.lrc}')">
                    ${i + 1}. ${song.title} - ${song.author}
                </div>
            `).join('');


            document.getElementById('results').innerHTML = html;
        }


        async function play(url, lrc) {
            const player = document.getElementById('player');
            player.src = url;
            player.play();


            // 获取歌词
            const res = await fetch(lrc);
            const text = await res.text();
            console.log('歌词:', text);
        }
    </script>
</body>
</html>

Vue.js 示例#

<template>
  <div>
    <input v-model="keyword" @keyup.enter="search" placeholder="搜索歌曲">
    <button @click="search">搜索</button>


    <div v-for="(song, index) in songs" :key="index" @click="play(song)">
      {{ index + 1 }}. {{ song.title }} - {{ song.author }}
    </div>


    <audio ref="player" controls></audio>
  </div>
</template>


<script>
export default {
  data() {
    return {
      API: 'https://你的域名/api',
      keyword: '',
      songs: []
    }
  },
  methods: {
    async search() {
      const res = await fetch(`${this.API}?server=netease&type=search&id=${this.keyword}`);
      this.songs = await res.json();
    },
    async play(song) {
      this.$refs.player.src = song.url;
      this.$refs.player.play();
    }
  }
}
</script>

错误码说明#

状态码说明
200请求成功
302重定向到资源（url/pic 类型）
400参数错误
401鉴权失败（Token 无效）
404资源不存在
500上游 API 调用失败

使用注意事项#

1. 缓存机制#

  • URL 缓存 10 分钟
  • 其他数据缓存 1 小时
  • 响应头 x-cache 显示缓存状态

2. 请求频率#

建议控制请求频率，避免被上游平台限流：

// 添加延迟
function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}


// 使用
await search('歌曲1');
await delay(1000); // 等待 1 秒
await search('歌曲2');

3. 跨域问题#

API 已配置 CORS，支持跨域请求。

4. HTTPS 要求#

  • 现代浏览器要求音频必须通过 HTTPS 播放
  • 确保使用 HTTPS 地址访问 API

常见问题#

Q1: Token 计算错误怎么办？#

确保：

  • 密钥与部署时设置的 METING_TOKEN 一致
  • 拼接顺序是 server + type + id
  • 使用 HMAC-SHA1 算法

Q2: 某些歌曲搜索不到？#

不同平台版权不同，可以：

  • 换个平台搜索
  • 尝试不同的关键词

Q3: 播放链接失效？#

  • URL 有缓存，可能已过期
  • 重新获取最新链接

Q4: 歌词乱码？#

歌词是 UTF-8 编码，确保：

  • 响应正确解码
  • 前端使用 UTF-8 显示

相关资源#

Waline 部署教程：云服务器篇
Meting-API 部署服务器指南

相关阅读

1Meting-API 部署服务器指南技术分享2Waline 部署教程：云服务器篇技术分享3手把手教你用 EdgeOne 加速 Vercel 部署的项目（源站域名分离法）技术分享4CloudFlare-ImgBed 系列：WebDAV + WinSCP 本地备份 Telegram 图片技术分享5手把手教你用 EdgeOne 加速 Cloudflare 图床，国内访问从 8 秒降到 0.15 秒技术分享

评论区

[ 公告 ]

如果你喜欢，那么欢迎来到我的世界！

了解更多
[ 音乐 ]
封面

音乐

暂未播放

0:000:00
暂无歌词
找不到相关结果。
[ contents ]
[ 全部文章 ]
工具
Copyright © 2025 团子和蛋糕 保留版权所有.
本站由 又拍云 提供 CDN 加速和云存储服务
© 2026团子和蛋糕. All Rights Reserved. /RSS /Sitemap
Powered byAstro &Firefly