音乐搜索 · 搜索音乐
目录路径:应用系列 / 音乐搜索 / 音乐搜索 · 搜索音乐
文档 slug:music-search-search
概述
按关键词搜索歌曲,返回可播放的音频直链、歌曲信息和封面。
平台已录入的说明(api_doc 原文)
搜索音乐
POST /api/v1/apps/music_search/search
按关键词返回可播放的音频直链、歌曲名称、作者、封面和歌曲页面链接。系统会自动过滤未返回播放地址的条目。
鉴权
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
当前接口为同步调用,成功时直接返回搜索结果;平台默认定价为 0.1 元/次,租户侧默认扣除 10 点/次。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 歌曲名、歌手名或专辑关键词 |
| page | integer | 否 | 页码,默认 1 |
| page_size | integer | 否 | 每页条数,默认 10,最大 20 |
请求示例
{"keyword":"晴天","page":1,"page_size":10}
成功响应
{
"code": 1,
"msg": "success",
"data": {
"result": {
"items": [
{
"type": "music",
"songid": "5257138",
"title": "屋顶",
"author": "周杰伦,温岚,吴宗宪",
"pic": "https://example.com/cover.jpg",
"link": "https://example.com/song/5257138",
"url": "https://example.com/music.mp3"
}
],
"page": 1,
"page_size": 10,
"has_more": true
},
"usage": {
"points_cost": 10,
"actual_points": 10
}
}
}
url 是可播放音频直链;songid、title、author、pic 与 link 分别表示歌曲标识、名称、作者、封面和歌曲页面链接。播放直链由服务实时返回,请以本次响应为准,不应长期缓存。
错误响应
{
"code": 0,
"msg": "音乐服务返回异常",
"data": null
}
鉴权
所有开放接口在请求头携带 API Key:
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
请求
POST /api/v1/apps/music_search/search
本接口在平台侧为 同步 调用。
请求体参数
| 参数 | 类型 | 必填 | 说明 | 默认值/可选值 |
|---|---|---|---|---|
page | integer | 否 | 页码,从 1 开始。 | 默认:1;示例:1 |
keyword | string | 否 | 歌曲名、歌手名或专辑关键词。 | 示例:晴天 |
page_size | integer | 否 | 每页条数,最大 20。 | 默认:10;示例:10 |
请求示例
{
"page": 1,
"page_size": 10
}
成功响应
{
"code": 1,
"msg": "success",
"data": {
}
}
_data 为业务实际返回,随接口而变。_
错误响应
{
"code": 0,
"msg": "错误说明",
"data": null
}
_HTTP 4xx/5xx 时也可能以统一 JSON 返回,也可能携带 data.error 等;以实际接口行为为准。_
_本页由 php think ai_developer_doc:sync_from_source 根据应用 API 元数据生成,可直接编辑。_