# 音乐卡片
**请求方式:** 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"
}
}
```