Smart Music · ruyi.ai開發者文檔

### 3.3.4 Smart Music #### （1）功能說明模糊場景下抽取關鍵詞智能推薦相關的音樂。 #### （2）接口說明 **請求方法** * POST **請求地址** * http://api.ruyi.ai/v1/message **請求參數說明** |參數名 |參數類型 | 是否必須 |參數說明 | :-----| :---| :---:|:----- |q |String| 是| 自然語言表達，例如“想去迪士尼樂園，給我放歌”，”我準備睡覺了，放個歌“等 |app_key| String|是 |應用開發者秘鑰，注冊開發者后臺賬號，建立虛擬助理后獲得 |user_id |String| 是 |用戶唯一標識，便于支持個性化語義解析。建議開發者使用 UUID 字符，且不同用戶必須用不同的 user_id，防止意圖串。 #### （3）返回說明 **返回參數說明** |名稱 |類型| 說明 |:---|:---|:--- |code |Integer | 返回代碼 |msg | String |返回代碼描述 |parameters|JSON Object |解析到的實體以及服務說明 |action|String|服務的接口名稱 |name| String|匹配的意圖名稱 |result | JSON Object| 接口返回內容 |outputs| Array| 服務輸出結果，微信端使用 type 類型為 wechat 開頭的內容;硬件端收到所有內容，依據需求解析使用 **返回代碼說明** |返回代碼 |錯誤類型|說明 |:---|:---|:--- |0／200 |成功 |請求成功 |400 |無效請求 |某些必需參數缺失或參數值錯誤，詳見msg字段 |401 |未授權 |授權失敗，app_key 缺失或錯誤 |403 |請求被禁止|有效請求，但服務拒絕響應，請聯系contact@ruyi.ai |408 |請求超時 |請求響應超時，一般響應時間設置為2000ms以內 |429 |短時間內大量訪問 |短時間內請求數過多 |500 |內部錯誤 |服務處理異常 |503 |服務不可用|服務異常或正在維護 #### （4）請求示例 **請求范例** _清晨的空氣真好，放一首歌吧_ _早晨起來聽得歌有么_ _今天真開心啊，給我放一首歌聽聽吧_ _好累啊，能給我播放一首歌么_ _今天上班真的是好難過，放首歌給我聽吧_ _我在跑步呢，適合聽點什么歌呢_ _有適合在迪廳里放的歌嗎_ _我要聽蔡依林的華語歌曲_ _我失戀了，能放首歌安慰我一下嗎_ _今天是大年三十啊，好喜慶呀，來點音樂吧_ **請求示例** * http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=我正在跑步，能播放一首歌嗎返回結果 ```json { "code": 0, "msg": "ok", "result": { "_text": "我正在跑步，能播放一首歌嗎", "msg_id": "362881f2-2d8e-4d95-a8b9-4e03723158b8", "intents": [ { "parameters": { "tag": "跑步", "service": "music" }, "action": "sys.action.kg/music/smart", "name": "smart music", "result": { "music_list": [ { "name": "All Over", "xiami": "1773487066", "image": "http://img.xiami.net/images/album/img69/9543269/95432751409543276_1.jpg", "artist": "CRUISR" }, { "name": "Brown Eyes", "xiami": "1770322515", "image": "http://img.xiami.net/images/album/img8/92608/4510701310352549_1.jpg", "artist": "Heather Batchelor" }, { "name": "Bach: Cello Suite No.1 in G major,Ⅰ Prelude", "xiami": "1771709960", "image": "http://img.xiami.net/images/album/img33/733/3620435201472659597_1.jpg", "artist": "Yo-Yo Ma" }, { "name": "Whistle For The Choir ", "xiami": "3427286", "image": "http://img.xiami.net/images/album/img11/24911/3096561385609811_1.jpg", "artist": "The Fratellis" }, { "name": "Fire Burning", "xiami": "1773334410", "image": "http://img.xiami.net/images/album/img2/720502/7205021404720502_1.jpg", "artist": "Fraser James" }, { "name": "Wrecking Ball", "xiami": "1769111701", "image": "http://img.xiami.net/images/album/img60/37160/3464571341354346_1.jpg", "artist": "Frankmusik" }, { "name": "You're Hot", "xiami": "2334594", "image": "http://img.xiami.net/images/album/img84/193984/i37224q2htv_1.jpg", "artist": "Sneaky Sound System" }, { "name": "Hunting For You", "xiami": "1771287734", "image": "http://img.xiami.net/images/album/img47/13247/5399331393392184_1.jpg", "artist": "Robbie Williams" }, { "name": "Put Out The Fire", "xiami": "1771746070", "image": "http://img.xiami.net/images/album/img64/275564/2755641363275564_1.jpg", "artist": "Abby Victor" }, { "name": "On The Radio", "xiami": "1770322194", "image": "http://img.xiami.net/images/album/img77/23477/4510431383620824_1.jpg", "artist": "Groove Coverage" }, { "name": "Radioactive", "xiami": "1771826011", "image": "http://img.xiami.net/images/album/img31/88831/18664786141366484000_1.jpg", "artist": "Imagine Dragons" }, { "name": "Can't Feel My Face", "xiami": "1776339768", "image": "http://img.xiami.net/images/album/img58/23258/21003798101471331019_1.jpg", "artist": "The Weeknd" }, { "name": "Numb Encore", "xiami": "1770087845", "image": "http://img.xiami.net/images/album/img66/11766/4305301300160789_1.jpg", "artist": "Eminem，Linkin Park，Dr. Dre，Jay Z，50 Cent" }, { "name": "Apocalyptica", "xiami": "1771132034", "image": "http://img.xiami.net/images/album/img88/112888/5251141341222708_1.jpg", "artist": "Nais" }, { "name": "Say Somethin", "xiami": "1770035708", "image": "http://img.xiami.net/images/album/img73/11573/4259021375328453.jpeg", "artist": "Mariah Carey，Snoop Dogg" }, { "name": "Turn Me On", "xiami": "1770804700", "image": "http://img.xiami.net/images/album/img16/27516/4937121376644000.jpeg", "artist": "Nicki Minaj，David Guetta" }, { "name": "My Feelings For You", "xiami": "1771080133", "image": "http://img.xiami.net/images/album/img83/81683/5202661339568916_1.jpg", "artist": "Avicii，Sebastien Drums" }, { "name": "Belisha Beacon", "xiami": "1769476352", "image": "http://img.xiami.net/images/album/img42/682442/1271682442_1.jpg", "artist": "Funki Porcini" }, { "name": "Bossa 24", "xiami": "1769455677", "image": "http://img.xiami.net/images/album/img26/73026/3758161270611400_1.jpg", "artist": "Ivana Parnasso" }, { "name": "You Are Dj", "xiami": "175438", "image": "http://img.xiami.net/images/album/img36/2636/14205_1.jpg", "artist": "芭比" } ], "msg": "ok", "text": "正在為您播放【CRUISR】的【All Over】，資源來自蝦米。", "type": "dialog" }, "outputs": [ { "type": "wechat.text", "property": { "text": "正在為您播放【CRUISR】的【All Over】，資源來自蝦米。" } }, { "type": "dialog", "property": { "text": "正在為您播放【CRUISR】的【All Over】，資源來自蝦米。", "emotion": "calm" } } ], "score": "1.0", "scoreColor": "c4", "is_match": 1, "skill_id": "bbb934f6-b869-4a91-9fd1-27bd7d0c0d0d", "id": "2df8a38f-380d-4625-85ed-121e576b72ea" } ], "meta_process_milliseconds": 252 } } ``` **詳細參數說明** |名稱 |類型| 說明 |:---|:---|:--- |service| String |服務名稱 |artist|String |歌手名 |music_list|Array|返回的歌曲列表 |id|String |源網站歌曲ID |pic| String |歌曲封面地址 |name|String |歌曲名稱