### 3.3.2 悅耳聲音 #### （1）功能說明 悅耳聲音提供大量的高品質音效素材，激發兒童對聲音的好奇心，感受不同聲音所帶來的獨特體驗。當前只支持硬件端使用，如若在微信端使用，請聯系客服cantact@ruyi.ai。 #### （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": "c16639d5-2544-4d8f-b522-11a4630f583b", "intents": [{ "parameters": { "any": "什么樣的", "service": "shengyin" }, "action": "other", "name": "鋼琴", "outputs": [{ "type": "voice", "property": { "name": "鋼琴 滑音.mp3", "voice_url": "http://o8naiyefa.bkt.clouddn.com/FjCBJWxwLE-m52Pa_-xw7twzNyC_/鋼琴 滑音.mp3" } }], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "01db18b4-a1db-4580-b1c6-b265e6fe3fde" }], "meta_process_milliseconds": 368 } } ``` **詳細參數說明** |名稱|類型|說明| |:---|:---|:--- |service | String |服務名稱 |voice_url|String|音頻鏈接