加载中...

基础信息

查看接口基本信息和返回格式
接口描述

为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"
}

计费标准

了解接口的计费方式和价格
VIP专享接口定价
VIP 免费
VIP免费专享
VIP会员免费使用,非会员无法访问
QPS限制
普通用户
不限
会员用户
不限
每日请求次数
普通用户
不限
会员用户
不限

安全认证

了解接口的认证方式和访问凭证管理
Token 认证

登录后可查看您的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 请求失败
服务器状态码

在线测试

在线调试接口,实时查看响应结果
发起请求
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