語音喚醒API接口【非語音轉文字】，支持Web、Windows、安卓等多平臺。無論你是想做智能硬件的“說話喚醒設備”，還是Web端的“網(wǎng)頁語音喚醒”，這套接口都能滿足。
接口核心信息
項目? 內容? 說明
接口地址? /api/ai/voicewakeup? 實際請求需拼接域名，如 /api/ai/voicewakeup
請求方式? GET / POST? 推薦使用 POST 以支持文件上傳
返回格式? application/json? 標準JSON格式
核心功能? 喚醒詞檢測、新增自定義喚醒詞? 支持離線/在線混合模式
準備工作
在開始編碼前，請完成以下兩步準備：
獲取Key：登錄酷虎云平臺，在“控制臺 -> 密鑰管理”中獲取你的 API Key。
準備音頻：
? ? 格式要求：16kHz采樣率、單聲道(Mono)、16-bit PCM的WAV文件。
? ? 錄制工具：你可以使用官方提供的 KWS音頻錄制工具 來錄制符合標準的測試音頻。
? ? 在線調試：支持使用 Apifox 進行可視化調試。
開發(fā)實戰(zhàn)：請求參數(shù)詳解
你需要根據(jù) type 參數(shù)來決定發(fā)送哪些數(shù)據(jù)。
場景一：喚醒詞檢測 (type=awaken)
用于檢測用戶說出的語音是否包含預設的喚醒詞。
請求參數(shù)：
? ? key: 你的API密鑰
? ? type: awaken
? ? audiofile: 上傳符合格式的WAV音頻文件（或Base64編碼文件）
場景二：新增自定義喚醒詞 (type=add_wakeword)
用于訓練系統(tǒng)識別新的喚醒詞（如“小虎小虎”）。
請求參數(shù)：
? ? key: 你的API密鑰
? ? type: add_wakeword
? ? wakeword: 例如 小虎小虎 (注意：通常需要付費或積分，且生效需要約10分鐘)
代碼示例 (Curl)
你可以直接在終端或代碼中使用以下模板：
喚醒檢測示例：
curl --location --request POST '/api/ai/voicewakeup' \
--form 'key="你的key"' \
--form 'type="awaken"' \
--form 'audiofile=@"/path/to/your/audio.wav"'
新增喚醒詞示例：
curl --location --request POST '/api/ai/voicewakeup' \
--form 'key="你的key"' \
--form 'type="add_wakeword"' \
--form 'wakeword="小虎小虎"'
返回結果解析
當請求成功（HTTP 200），你會收到如下JSON數(shù)據(jù)：
{
? "code": 200,
? "msg": "喚醒成功",
? "timestamp": 1776757572,
? "datetime": "2026-04-21 15:46:12",
? "data": {
? ? "keyword": "小虎小虎",
? ? "count": 1,
? ? "duration_sec": 2.816,
? ? "elapsed_ms": 49.01,
? ? "awakened": true,
? ? "deducted_amount": 1,
? ? "deducted_points": 10
? }
}
關鍵字段：
? ? data.keyword: 實際被檢測到的喚醒詞。
? ? data.awakened: 布爾值，true 表示喚醒成功，你的程序可以在這里觸發(fā)后續(xù)邏輯（如打開空調、開始對話等）。
? ? data.deducted_points: 扣除的積分/費用，用于計費監(jiān)控。
給新手的特別提示
音頻質量是關鍵：如果喚醒失敗，請務必檢查音頻是否為 16kHz, 16-bit, 單聲道。很多錄音軟件默認是44.1kHz，這會導致識別失敗。
環(huán)境噪音：盡量在安靜環(huán)境下測試，或者使用支持降噪的麥克風。
自定義喚醒詞：新增的喚醒詞（如add_wakeword）通常需要服務器進行模型訓練，文檔中提到預計 10分鐘 生效，請耐心等待。
來源：酷虎云api開放平臺
