/ 接口详情
娇娇Music
JOOX 音乐接口，支持搜索、歌曲源、歌词、专辑、歌手、歌单、导入单曲、播放与下载。
接口信息
GET / POST
api.vsaa.cn/api/music/joox/index.php
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| key | string | 是 | 接口调用密钥 | |
| action | string | 是 | 操作类型：search / musicSource / lyric / albumInfo / artistWorks / sheetInfo / importItem / topLists / topListDetail / play / down / qualities | |
| country | string | 否 | 地区，默认 hk（可选 hk / th / my / id） | |
| lang | string | 否 | 语言，默认 zh_CN | |
| keyword | string | 否 | 搜索关键词（action=search 必填） | |
| page | integer | 否 | 页码，默认 1（search / artistWorks / sheetInfo / topListDetail 使用） | |
| type | string | 否 | 类型：music / album / artist / sheet，默认 music（action=search、artistWorks 使用） | |
| id | string | 否 | 歌曲 / 专辑 / 艺人 / 歌单 / 榜单 ID（action=musicSource、lyric、albumInfo、artistWorks、sheetInfo、topListDetail 必填） | |
| songmid | string | 否 | 歌曲 songmid，搜索返回项中携带（action=musicSource 可选） | |
| quality | string | 否 | 音质：128k / 192k / 320k / flac / hires / atmos / master，默认 128k（action=musicSource 使用） | |
| url | string | 否 | JOOX 链接 / 歌曲 ID 或音乐直链（action=importItem 必填，action=play、down 为音乐直链） | |
| filename | string | 否 | 下载文件名，不填自动生成（action=down 可选） |
[
{
"name": "key",
"type": "string",
"required": true,
"description": "接口调用密钥",
"example": ""
},
{
"name": "action",
"type": "string",
"required": true,
"description": "操作类型：search / musicSource / lyric / albumInfo / artistWorks / sheetInfo / importItem / topLists / topListDetail / play / down / qualities",
"example": ""
},
{
"name": "country",
"type": "string",
"required": false,
"description": "地区，默认 hk（可选 hk / th / my / id）",
"example": ""
},
{
"name": "lang",
"type": "string",
"required": false,
"description": "语言，默认 zh_CN",
"example": ""
},
{
"name": "keyword",
"type": "string",
"required": false,
"description": "搜索关键词（action=search 必填）",
"example": ""
},
{
"name": "page",
"type": "integer",
"required": false,
"description": "页码，默认 1（search / artistWorks / sheetInfo / topListDetail 使用）",
"example": ""
},
{
"name": "type",
"type": "string",
"required": false,
"description": "类型：music / album / artist / sheet，默认 music（action=search、artistWorks 使用）",
"example": ""
},
{
"name": "id",
"type": "string",
"required": false,
"description": "歌曲 / 专辑 / 艺人 / 歌单 / 榜单 ID（action=musicSource、lyric、albumInfo、artistWorks、sheetInfo、topListDetail 必填）",
"example": ""
},
{
"name": "songmid",
"type": "string",
"required": false,
"description": "歌曲 songmid，搜索返回项中携带（action=musicSource 可选）",
"example": ""
},
{
"name": "quality",
"type": "string",
"required": false,
"description": "音质：128k / 192k / 320k / flac / hires / atmos / master，默认 128k（action=musicSource 使用）",
"example": ""
},
{
"name": "url",
"type": "string",
"required": false,
"description": "JOOX 链接 / 歌曲 ID 或音乐直链（action=importItem 必填，action=play、down 为音乐直链）",
"example": ""
},
{
"name": "filename",
"type": "string",
"required": false,
"description": "下载文件名，不填自动生成（action=down 可选）",
"example": ""
}
]
{
"openapi": "3.1.1",
"info": {
"title": "娇娇Music",
"description": "JOOX 音乐接口，支持搜索、歌曲源、歌词、专辑、歌手、歌单、导入单曲、播放与下载。",
"version": "1.0.0"
},
"paths": {
"\/api\/music\/joox\/index.php": {
"get": {
"summary": "娇娇Music",
"description": "JOOX 音乐接口，支持搜索、歌曲源、歌词、专辑、歌手、歌单、导入单曲、播放与下载。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "操作类型：search \/ musicSource \/ lyric \/ albumInfo \/ artistWorks \/ sheetInfo \/ importItem \/ topLists \/ topListDetail \/ play \/ down \/ qualities"
},
{
"name": "country",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "地区，默认 hk（可选 hk \/ th \/ my \/ id）"
},
{
"name": "lang",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "语言，默认 zh_CN"
},
{
"name": "keyword",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "搜索关键词（action=search 必填）"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "页码，默认 1（search \/ artistWorks \/ sheetInfo \/ topListDetail 使用）"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "类型：music \/ album \/ artist \/ sheet，默认 music（action=search、artistWorks 使用）"
},
{
"name": "id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "歌曲 \/ 专辑 \/ 艺人 \/ 歌单 \/ 榜单 ID（action=musicSource、lyric、albumInfo、artistWorks、sheetInfo、topListDetail 必填）"
},
{
"name": "songmid",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "歌曲 songmid，搜索返回项中携带（action=musicSource 可选）"
},
{
"name": "quality",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "音质：128k \/ 192k \/ 320k \/ flac \/ hires \/ atmos \/ master，默认 128k（action=musicSource 使用）"
},
{
"name": "url",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "JOOX 链接 \/ 歌曲 ID 或音乐直链（action=importItem 必填，action=play、down 为音乐直链）"
},
{
"name": "filename",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "下载文件名，不填自动生成（action=down 可选）"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"post": {
"summary": "娇娇Music",
"description": "JOOX 音乐接口，支持搜索、歌曲源、歌词、专辑、歌手、歌单、导入单曲、播放与下载。",
"parameters": [
{
"name": "key",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "接口调用密钥"
},
{
"name": "action",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "操作类型：search \/ musicSource \/ lyric \/ albumInfo \/ artistWorks \/ sheetInfo \/ importItem \/ topLists \/ topListDetail \/ play \/ down \/ qualities"
},
{
"name": "country",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "地区，默认 hk（可选 hk \/ th \/ my \/ id）"
},
{
"name": "lang",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "语言，默认 zh_CN"
},
{
"name": "keyword",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "搜索关键词（action=search 必填）"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "页码，默认 1（search \/ artistWorks \/ sheetInfo \/ topListDetail 使用）"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "类型：music \/ album \/ artist \/ sheet，默认 music（action=search、artistWorks 使用）"
},
{
"name": "id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "歌曲 \/ 专辑 \/ 艺人 \/ 歌单 \/ 榜单 ID（action=musicSource、lyric、albumInfo、artistWorks、sheetInfo、topListDetail 必填）"
},
{
"name": "songmid",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "歌曲 songmid，搜索返回项中携带（action=musicSource 可选）"
},
{
"name": "quality",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "音质：128k \/ 192k \/ 320k \/ flac \/ hires \/ atmos \/ master，默认 128k（action=musicSource 使用）"
},
{
"name": "url",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "JOOX 链接 \/ 歌曲 ID 或音乐直链（action=importItem 必填，action=play、down 为音乐直链）"
},
{
"name": "filename",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "下载文件名，不填自动生成（action=down 可选）"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口（https）"
}
]
}
详细文档
暂无详细文档
快速上手
暂无代码示例。管理员可在后台用 AI 生成或手动编写。
在线测试
请求地址
api.vsaa.cn/api/music/joox/index.php
Method
参数
Response
// 结果将在此处显示
接口反馈
免责声明
免责声明
欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期：2026年10月6日
