基础信息
查看接口基本信息和返回格式 接口描述
为QQ机器人,微信插件提供音乐搜索和播放功能,支持黄白助手格式
七日请求统计
本周总请求: -
日均: -
请求方式
GET
POST 推荐
请求地址
https://api.cxzja.cn/api/kgmusicbot
返回方式
JSON
默认返回格式,包含完整数据结构
返回预览
JSON
{
"code": 200,
"title": "七里香",
"singer": "周杰伦",
"cover": "http://imge.kugou.com/stdmusic/1080/20250125/20250125121745628430.jpg",
"link": "https://www.kugou.com/song/#hash=2c7ceb6cc2340ecc8948e0ace62f0cf8",
"music_url": "http://fsandroid.kugou.com/202606251040/bda1cf69379161dd5aead503dba4dc82/v3/7ddd6c7755ba848f04942c00c1d35c7e/yp/full/ap3293_us2191351204_mi336d5ebc5436534e61d16e63ddfca327_pi2_qu320_pa151369488_ct330200_s195075619.mp3",
"lyric": "[id:$00000000]
[ar:周杰伦]
[ti:七里香]
[by:]
[hash:2c7ceb6cc2340ecc8948e0ace62f0cf8]
[al:七里香]
[sign:]
[qq:]
[total:0]
[offset:0]
[00:00.00]周杰伦 - 七里香
[00:06.93]词:方文山
[00:13.87]曲:周杰伦
[00:20.80]编曲:钟兴民
[00:27.74]窗外的麻雀在电线杆上多嘴
[00:34.49]你说这一句很有夏天的感觉
[00:41.16]手中的铅笔在纸上来来回回
[00:47.59]我用几行字形容你是我的谁
[00:54.39]秋刀鱼的滋味猫跟你都想了解
[01:01.44]初恋的香味就这样被我们寻回
[01:07.81]那温暖的阳光像刚摘的鲜艳草莓
[01:14.37]你说你舍不得吃掉这一种感觉
[01:20.99]雨下整夜我的爱溢出就像雨水
[01:27.65]院子落叶跟我的思念厚厚一叠
[01:34.38]几句是非也无法将我的热情冷却
[01:41.92]你出现在我诗的每一页
[01:47.86]雨下整夜我的爱溢出就像雨水
[01:54.60]窗台蝴蝶像诗里纷飞的美丽章节
[02:01.38]我接着写
[02:03.86]把永远爱你写进诗的结尾
[02:08.99]你是我唯一想要的了解
[02:42.02]雨下整夜我的爱溢出就像雨水
[02:48.62]院子落叶跟我的思念厚厚一叠
[02:55.37]几句是非也无法将我的热情冷却
[03:02.96]你出现在我诗的每一页
[03:09.38]那饱满的稻穗幸福了这个季节
[03:16.54]而你的脸颊像田里熟透的番茄
[03:22.81]你突然对我说七里香的名字很美
[03:29.28]我此刻却只想亲吻你倔强的嘴
[03:35.91]雨下整夜我的爱溢出就像雨水
[03:42.58]院子落叶跟我的思念厚厚一叠
[03:49.38]几句是非也无法将我的热情冷却
[03:56.93]你出现在我诗的每一页
[04:03.33]整夜我的爱溢出就像雨水
[04:09.58]窗台蝴蝶像诗里纷飞的美丽章节
[04:16.43]我接着写
[04:18.97]把永远爱你写进诗的结尾
[04:24.00]你是我唯一想要的了解
",
"cached_time": "2026-06-25 10:40:36",
"api_source": "API官网:api.cxzja.cn",
"timestamp": "2026-06-25 10:40:36"
}计费标准
了解接口的计费方式和价格
付费接口定价
付费
每日免费
10
次
超出后计费
普通用户
额度消耗
5额度/次
余额扣费
0.001元/次
会员用户
调用费用
免费
QPS限制
普通用户
不限
会员用户
不限
每日请求次数
普通用户
不限
会员用户
不限
安全认证
了解接口的认证方式和访问凭证管理 Token 认证
实名认证
无需实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
推荐
Header 认证
通过 HTTP Header 传递认证信息
Authorization
Bearer {access_token}或通过curl请求参数传递:
curl
curl "https://api.cxzja.cn/api/kgmusicbot?token=YOUR_TOKEN"
参数文档
查看接口请求参数和返回字段说明 请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
| token | string | 必填 | 无 | 登录后显示你的请求token | 接口请求唯一认证标识! |
| msg | string | 必填 | 关键词 | ||
| n | string | 必填 | 序号 | ||
| id | string | 必填 | 酷狗歌曲hash | ||
| br | string | 必填 | 音质 1234 | ||
| type | string | 必填 | hb,mp3(二选一仅选择mp3返回 mp3 播放链接文本) | ||
| hb | string | 必填 | yes | ||
| name | string | 必填 | 关键词(黄白助手 hb 模式)必填 |
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code
|
int | 返回状态码 |
状态码
了解接口返回的状态码含义及处理方式 接口状态码
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 201 | 请求失败 |
服务器状态码
| 状态码 | 说明 |
|---|---|
| 500 | 服务器错误 |
| 501 | 请求接口不存在 |
| 502 | 请求接口已下架 |
| 503 | 请求接口维护中 |
| 504 | 缺少请求token参数 |
| 505 | 请求token不存在 |
| 506 | 请求token已被封禁 |
| 507 | 请求token额度不足 |
| 508 | 今日请求token已达上限 |
| 509 | 请求ip不在token白名单内 |
| 510 | 请求token无权使用当前接口 |
| 511 | 接口请求频率过高,请稍后再试 |
| 512 | 该接口未开启在线测试功能 |
| 513 | 今日在线测试次数已达上限 |
| 514 | 今日该接口请求次数已达上限 |
| 515 | 该接口为会员专属接口,请携带会员token |
| 516 | 该接口为会员专属接口,请开通会员 |
| 517 | 接口请求过于频繁,已被临时限制 |
| 518 | 该接口需要实名认证,请先完成实名认证 |
| 519 | 当前Token今日请求次数已达上限 |
| 520 | 当前Token已被禁止使用 |
| 521 | 请求token余额不足 |
| 522 | 请求token额度和余额均不足 |
| 530 | 接口服务异常,请稍后再试 |
| 531 | 接口响应超时 |
| 532 | 接口返回数据格式错误 |
| 533 | 接口请求失败 |
在线测试
在线调试接口,实时查看响应结果 发起请求
GET/POST
示例代码
多种语言的接口调用示例PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言
PHP
<?php
$API_TOKEN = 'YOUR_TOKEN';
$API_URL = 'https://api.cxzja.cn/api/kgmusicbot';
$params = array(
'token' => 'YOUR_TOKEN',
'msg' => '参数值',
'n' => '参数值',
'id' => '参数值',
'br' => '参数值',
'type' => '参数值',
'hb' => '参数值',
'name' => '参数值',
);
$res = api::send($API_URL, $params, 'GET/POST');
print($res);
class api {
public static function send($url, $data, $type) {
$data = http_build_query($data);
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
} else {
curl_setopt($ch, CURLOPT_URL, $url . '?' . $data);
}
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$res = curl_exec($ch);
curl_close($ch);
return $res;
}
}JavaScript
$.ajax({
url: 'https://api.cxzja.cn/api/kgmusicbot',
data: {
token: 'YOUR_TOKEN',
msg: '参数值',
n: '参数值',
id: '参数值',
br: '参数值',
type: '参数值',
hb: '参数值',
name: '参数值',
},
type: 'GET/POST',
dataType: 'json',
success: function(data) {
console.log(data);
},
error: function(err) {
console.log('请求失败', err);
}
});Python
import requests
url = "https://api.cxzja.cn/api/kgmusicbot"
data = {
"token": "YOUR_TOKEN",
"msg": "参数值",
"n": "参数值",
"id": "参数值",
"br": "参数值",
"type": "参数值",
"hb": "参数值",
"name": "参数值",
}
response = requests.post(url, data=data)
print(response.json())Java
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;
public class ApiRequest {
public static void main(String[] args) throws Exception {
URL url = new URL("https://api.cxzja.cn/api/kgmusicbot");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET/POST");
conn.setConnectTimeout(10000);
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream()));
String line;
StringBuilder result = new StringBuilder();
while ((line = reader.readLine()) != null) {
result.append(line);
}
reader.close();
System.out.println(result.toString());
}
}Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
"strings"
)
func main() {
data := "token=YOUR_TOKEN&msg=%E5%8F%82%E6%95%B0%E5%80%BC&n=%E5%8F%82%E6%95%B0%E5%80%BC&id=%E5%8F%82%E6%95%B0%E5%80%BC&br=%E5%8F%82%E6%95%B0%E5%80%BC&type=%E5%8F%82%E6%95%B0%E5%80%BC&hb=%E5%8F%82%E6%95%B0%E5%80%BC&name=%E5%8F%82%E6%95%B0%E5%80%BC"
resp, _ := http.Post("https://api.cxzja.cn/api/kgmusicbot",
"application/x-www-form-urlencoded", strings.NewReader(data))
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}C#
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
using var client = new HttpClient();
var data = new FormUrlEncodedContent(new Dictionary<string, string> {
{"token", "YOUR_TOKEN"},
{"msg", "参数值"},
{"n", "参数值"},
{"id", "参数值"},
{"br", "参数值"},
{"type", "参数值"},
{"hb", "参数值"},
{"name", "参数值"},
});
var response = await client.PostAsync("https://api.cxzja.cn/api/kgmusicbot", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(response);
}
}NodeJs
const https = require('https');
const querystring = require('querystring');
const postData = querystring.stringify({
'token': 'YOUR_TOKEN',
'msg': '参数值',
'n': '参数值',
'id': '参数值',
'br': '参数值',
'type': '参数值',
'hb': '参数值',
'name': '参数值',
});
const options = {
hostname: 'api.cxzja.cn',
path: '/api/kgmusicbot',
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
};
const req = https.request(options, res => {
let data = '';
res.on('data', d => data += d);
res.on('end', () => console.log(data));
});
req.write(postData);
req.end();
C
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>
static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
((char*)userp)[0] = '\0';
strcat(userp, contents);
return size * nmemb;
}
int main() {
CURL *curl;
CURLcode res;
char response[4096] = {0};
curl_global_init(CURL_GLOBAL_DEFAULT);
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/kgmusicbot");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&msg=%E5%8F%82%E6%95%B0%E5%80%BC&n=%E5%8F%82%E6%95%B0%E5%80%BC&id=%E5%8F%82%E6%95%B0%E5%80%BC&br=%E5%8F%82%E6%95%B0%E5%80%BC&type=%E5%8F%82%E6%95%B0%E5%80%BC&hb=%E5%8F%82%E6%95%B0%E5%80%BC&name=%E5%8F%82%E6%95%B0%E5%80%BC");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) printf("%s\n", response);
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}C++
#include <iostream>
#include <string>
#include <curl/curl.h>
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
userp->append((char*)contents, size * nmemb);
return size * nmemb;
}
int main() {
CURL* curl = curl_easy_init();
std::string response;
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/kgmusicbot");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&msg=%E5%8F%82%E6%95%B0%E5%80%BC&n=%E5%8F%82%E6%95%B0%E5%80%BC&id=%E5%8F%82%E6%95%B0%E5%80%BC&br=%E5%8F%82%E6%95%B0%E5%80%BC&type=%E5%8F%82%E6%95%B0%E5%80%BC&hb=%E5%8F%82%E6%95%B0%E5%80%BC&name=%E5%8F%82%E6%95%B0%E5%80%BC");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
CURLcode res = curl_easy_perform(curl);
if (res == CURLE_OK) std::cout << response << std::endl;
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}易语言
.版本 2 .支持库 spec .局部变量 url, 文本型 .局部变量 params, 文本型 .局部变量 result, 文本型 url = "https://api.cxzja.cn/api/kgmusicbot" params = "token=YOUR_TOKEN&msg=%E5%8F%82%E6%95%B0%E5%80%BC&n=%E5%8F%82%E6%95%B0%E5%80%BC&id=%E5%8F%82%E6%95%B0%E5%80%BC&br=%E5%8F%82%E6%95%B0%E5%80%BC&type=%E5%8F%82%E6%95%B0%E5%80%BC&hb=%E5%8F%82%E6%95%B0%E5%80%BC&name=%E5%8F%82%E6%95%B0%E5%80%BC" result = 编码_URL解码 (网页_访问 (url, , params)) 调试输出 (result)
AI开发文档
导出接口文档供AI助手快速理解接口结构
复制下方内容粘贴给AI助手,即可快速生成对接代码。
JSON 格式
0 KB