# 音乐卡片

**请求方式:** GET|POST

**接口地址:** https://api.hk0.cc/api/musiccard

**接口描述:** 生成音乐分享卡片:支持 QQ音乐、网易云音乐、酷我音乐、酷狗音乐、咪咕音乐、汽水音乐及自定义信息,输出 JSON 签名 / PNG / SVG / HTML

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| platform | string | 1 | 可选 | — | — | 平台:qq / netease / kuwo / kugou / migu / qishui / universal,也支持 type |
| id | string | 2 | 可选 | — | — | 歌曲ID,提供后自动解析标题、歌手、专辑、封面与音频 |
| share | string | 3 | 可选 | — | — | 歌曲分享链接,自动解析歌曲信息,也支持 link |
| title | string | 4 | 可选 | — | — | 卡片标题,无法解析歌曲时必填,也支持 name / song;song 含 http 时按分享链接处理 |
| desc | string | 5 | 可选 | — | — | 歌手或描述,也支持 singer |
| album | string | 6 | 可选 | — | — | 专辑名 |
| image | string | 7 | 可选 | — | — | 封面图片URL,也支持 cover / pic |
| audio | string | 8 | 可选 | — | — | 音频直链URL,也支持 music / mp3 |
| jump | string | 9 | 可选 | — | — | 点击跳转URL,也支持 url |
| theme | string | 10 | 可选 | — | — | 主题:dark / light,默认 dark |
| format | string | 11 | 可选 | — | — | 输出格式:json / png / svg / html,默认 json |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "platform": "qq",
    "platformName": "QQ音乐",
    "title": "晴天",
    "desc": "周杰伦",
    "album": "叶惠美",
    "image": "https://y.gtimg.cn/music/photo_new/T002R500x500M000000MkMni19ClKG.jpg",
    "audio": "https://example.com/preview.m4a",
    "jumpUrl": "https://y.qq.com/n/ryqq/songDetail/0039MnYb0qxYhV",
    "theme": "dark",
    "version": "1.0.1",
    "sign": "b68372f6ceff4c14a4f985f3e0a65189",
    "cardUrl": "https://api.hk0.cc/api/musiccard?platform=qq&format=png",
    "svgUrl": "https://api.hk0.cc/api/musiccard?platform=qq&format=svg",
    "htmlUrl": "https://api.hk0.cc/api/musiccard?platform=qq&format=html"
  }
}
```