音乐搜索 · 搜索音乐

目录路径:应用系列 / 音乐搜索 / 音乐搜索 · 搜索音乐
文档 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 点/次。

参数类型必填说明
keywordstring是歌曲名、歌手名或专辑关键词
pageinteger否页码,默认 1
page_sizeinteger否每页条数,默认 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

本接口在平台侧为 同步 调用。

请求体参数

参数类型必填说明默认值/可选值
pageinteger否页码,从 1 开始。默认:1;示例:1
keywordstring否歌曲名、歌手名或专辑关键词。示例:晴天
page_sizeinteger否每页条数,最大 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 元数据生成,可直接编辑。_

同类文章