汽水音乐解析API:一键提取音乐元数据

正在加载问候语...

汽水音乐(Qishui Yinyue)是抖音旗下的音乐流媒体服务平台,凭借其便捷的音乐分享功能广受欢迎。然而,该平台存在两个主要限制:一是音乐文件无法下载保存到汽水音乐APP之外;二是部分音乐需要VIP会员才能下载。针对这些问题,您可以通过本站提供的API接口获取隐藏的音乐地址,从而实现绕过VIP限制下载包括不限于音乐,并将其保存到汽水音乐APP以外的设备中。并且该API易于集成,响应快速,适用于Web、移动端和后端开发场景。

图片[1]-汽水音乐解析API:一键提取音乐元数据

API地址https://short-video.joyb.cc/api/qsmusic.php

核心功能

  • 一键解析:从分享链接提取歌曲名称、音频URL和封面图片甚至歌词文件地址。
  • 轻量设计:API调用简单,响应数据清晰,易于处理。
  • 高兼容性:支持多种编程语言和平台。
  • 稳定可靠:优化后的服务确保低延迟和高可用性。

无论你是开发音乐播放器、社交媒体工具,还是进行音乐数据分析,汽水音乐解析API都能为你提供强大支持。以下是详细的使用教程和开发文档,助你快速上手!


使用教程:如何调用汽水音乐解析API

1. 获取汽水音乐分享链接

在汽水音乐App或抖音App中,找到目标音乐,点击分享按钮,复制分享链接。例如:

《atmosphere》@汽水音乐 https://qishui.douyin.com/s/iaujNfKo/

2. 构造API请求

API使用GET方法,请求格式如下:

https://short-video.joyb.cc/api/qsmusic.php?url={分享链接}

分享链接需进行URL拼接,浏览器访问会自动编码,确保特殊字符正确处理。例如:

https://short-video.joyb.cc/api/qsmusic.php?url=https://qishui.douyin.com/s/iaujNfKo/

3. 发送请求并处理响应

你可以通过浏览器、Postman、cURL或编程语言发送请求。API返回JSON格式的数据,包含音乐元数据。以下是示例响应:

{
    "name": "《atmosphere》@汽水音乐",
    "url": "https://v5-luna.douyinvod.com/cac00fba542db6affb776d5fa30399ae/6821074d/video/tos/cn/tos-cn-ve-2774/oE2e0QaDPCNwSdfFEB5GtFIjaBGmfztABzM4TH/?a=8478&ch=0&cr=5&dr=0&cd=0%7C0%7C0%7C5&br=126&bt=126&ft=V79LgMTERR0s~pC1kDv2Nc0iPMgzbLsbVVdU_4yfHCV9Nv7TGW&mime_type=audio_mp4&qs=6&rc=ZTgzO2k1Z2g6NDVoOjVpOUBpM2xncnI5cjQ2eTMzNDlkM0BfYzY1Ll9eNTMxXi1gMS0zYSNvcjE1MmRzY2dgLS1kYWFzcw%3D%3D&btag=c0000e00028000&dy_q=1746904899&l=20250511032139C9138476A3F0A2646A43",
    "cover": "https://p3-luna.douyinpic.com/img/tos-cn-v-2774c002/o8CrBOfDGI8nzMPaubVcHzzGMCxFeEeAFAAIIA~c5_375x375.jpg",
    "lyrics": "",
    "core": "抖音汽水音乐解析",
    "copyright": "接口编写:JH-Ahua 接口编写:JH-Ahua 2025-4-20"
}

字段说明

  • name:歌曲名称,可能包含平台标识(如“@汽水音乐”)。
  • url:音频文件URL,可直接用于播放或下载。
  • cover:封面图片URL,通常为375×375像素。
  • lyrics:歌词内容(当前为空,如果当前音乐有的话)。
  • core:API核心描述,表明服务来源。
  • copyright:版权信息,包含作者和日期。

4. 示例代码

以下是几种编程语言调用API的示例代码,展示如何解析响应数据:

import requests
import urllib.parse

# 分享链接
share_url = "https://qishui.douyin.com/s/iaujNfKo/"
# URL编码
encoded_url = urllib.parse.quote(share_url)
# 构造API请求
api_url = f"https://short-video.joyb.cc/api/qsmusic.php?url={encoded_url}"

# 发送请求
try:
    response = requests.get(api_url, timeout=5)
    response.raise_for_status()  # 检查HTTP状态
    data = response.json()
    print("歌曲名称:", data["name"])
    print("音频URL:", data["url"])
    print("封面URL:", data["cover"])
except requests.RequestException as e:
    print("请求失败:", str(e))
const axios = require('axios');
const encodeUrl = require('encodeurl');

const shareUrl = "https://qishui.douyin.com/s/iaujNfKo/";
const encodedUrl = encodeUrl(shareUrl);
const apiUrl = `https://short-video.joyb.cc/api/qsmusic.php?url=${encodedUrl}`;

axios.get(apiUrl)
  .then(response => {
    console.log("歌曲名称:", response.data.name);
    console.log("音频URL:", response.data.url);
    console.log("封面URL:", response.data.cover);
  })
  .catch(error => {
    console.error("请求失败:", error.message);
  });
curl "https://short-video.joyb.cc/api/qsmusic.php?url=https%3A%2F%2Fqishui.douyin.com%2Fs%2FiaujNfKo%2F"

5. 错误处理

API可能返回以下错误情况(基于常见HTTP状态码和响应推测):

  • HTTP 400:分享链接格式错误,请检查URL。
  • HTTP 404:音乐资源不存在,可能链接已失效。
  • HTTP 500:服务器内部错误,请稍后重试。

开发文档:汽水音乐解析API

API概述

  • 端点https://short-video.joyb.cc/api/qsmusic.php
  • 方法:GET
  • 参数:url(必填)、汽水音乐分享链接,需URL编码。
  • 响应格式:JSON
  • 限速:暂无明确限速,建议每秒不超过5次请求。

请求示例

GET https://short-video.joyb.cc/api/qsmusic.php?url=https%3A%2F%2Fqishui.douyin.com%2Fs%2FiaujNfKo%2F

响应字段

字段类型描述
namestring歌曲名称,可能含平台标识
urlstring音频文件URL
coverstring封面图片URL
lyricsstring歌词内容(当前为空)
corestringAPI核心描述
copyrightstring版权信息,包含作者和日期

错误处理

状态码描述
200成功
400分享链接格式错误
404音乐资源不存在
500服务器内部错误

集成注意事项

  1. URL编码:分享链接必须URL编码,避免特殊字符导致请求失败。
  2. 音频URL有效期:音频URL可能有时间限制,建议解析后尽快使用。
  3. 版权合规:使用解析数据时,需遵守汽水音乐和抖音的版权政策,仅限合法用途。
  4. 请求超时:建议设置5秒超时,处理网络不稳定情况。
  5. 频率控制:避免高频请求,保持合理调用频率。
  6. 歌词支持:当前lyrics字段为空,未来可能更新,建议检查文档。

常见问题

Q:API是否需要认证?
A:当前无需认证,直接调用即可。

Q:音频URL可以直接下载吗?
A:可以,但需注意URL可能有有效期,建议及时使用。

Q:支持解析其他平台链接吗?
A:当前仅支持汽水音乐分享链接。

© 版权声明
THE END
喜欢就支持一下吧
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容