语义接口

查看 llm.txt

最后一次编辑于 2026-04-06

语义接口

目前提供音乐、百科、闲聊、股票、FM、天气、股票、闹钟的语义的解析。

说明:提供对文本请求返回语义槽位的相关结果

请求

请求地址:

https://{BASE_URL}/xwcloudapi/semantic

请求方式:post
请求参数:
 参数类型:json
 参数字段:
示例
{
    "query": "我想听周杰伦的歌曲"
    "请求接口基础参数":{xxxxx}  // 详见**请求接口基础参数说明**章节
}

返回

结果格式: json
结果字段:
字段 类型 备注说明
code int 0成功非零失败
msg string 结果的文字描述
data json 详细结果字段
data.query string 用户的请求文本
data.node string 用户请求分类
data.title string 用户请求意图
data.slots array 用户请求解析的槽位信息
data.tts String 返回合适播放的文本信息
说明

其中data.slots 为数组,每个item 是:类型{key:value} 其中的key 和value类型都为字符串.

音乐意图下,key的取值包括: 榜单, 发行版本,歌词,,歌曲类型,歌曲名,歌曲语言,歌手名,季度,年代,排序,期数,其他版本,影视剧名,专辑,综艺名 value 有值则有值,没有值,则为空。

返回示例:
{
    "code": 0,
    "data": {
        "node": "音乐",
        "query": "我想听七里香",
        "slots": [
            {
                "榜单": ""
            },
            {
                "发行版本": ""
            },
            {
                "歌词": ""
            },
            {
                "歌曲类型": ""
            },
            {
                "歌曲名": "七里香"
            },
            {
                "歌曲语言": ""
            },
            {
                "歌手名": ""
            },
            {
                "季度": ""
            },
            {
                "年代": ""
            },
            {
                "排序": ""
            },
            {
                "期数": ""
            },
            {
                "其他版本": ""
            },
            {
                "影视剧名": ""
            },
            {
                "专辑": ""
            },
            {
                "综艺名": ""
            }
        ],
        "title": "点歌播放"
    },
    "msg": "OK"
}