语音唤醒API接口【非语音转文字】，支持Web、Windows、安卓等多平台。无论你是想做智能硬件的“说话唤醒设备”，还是Web端的“网页语音唤醒”，这套接口都能满足。
接口核心信息
项目 内容 说明
接口地址 /api/ai/voicewakeup 实际请求需拼接域名，如 /api/ai/voicewakeup
请求方式 GET / POST 推荐使用 POST 以支持文件上传
返回格式 application/json 标准JSON格式
核心功能 唤醒词检测、新增自定义唤醒词 支持离线/在线混合模式
准备工作
在开始编码前，请完成以下两步准备：
获取Key：登录酷虎云平台，在“控制台 -> 密钥管理”中获取你的 API Key。
准备音频：
格式要求：16kHz采样率、单声道(Mono)、16-bit PCM的WAV文件。
录制工具：你可以使用官方提供的 KWS音频录制工具 来录制符合标准的测试音频。
在线调试：支持使用 Apifox 进行可视化调试。
开发实战：请求参数详解
你需要根据 type 参数来决定发送哪些数据。
场景一：唤醒词检测 (type=awaken)
用于检测用户说出的语音是否包含预设的唤醒词。
请求参数：
key: 你的API密钥
type: awaken
audiofile: 上传符合格式的WAV音频文件（或Base64编码文件）
场景二：新增自定义唤醒词 (type=add_wakeword)
用于训练系统识别新的唤醒词（如“小虎小虎”）。
请求参数：
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数据：
{
"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 表示唤醒成功，你的程序可以在这里触发后续逻辑（如打开空调、开始对话等）。
data.deducted_points: 扣除的积分/费用，用于计费监控。
给新手的特别提示
音频质量是关键：如果唤醒失败，请务必检查音频是否为 16kHz, 16-bit, 单声道。很多录音软件默认是44.1kHz，这会导致识别失败。
环境噪音：尽量在安静环境下测试，或者使用支持降噪的麦克风。
自定义唤醒词：新增的唤醒词（如add_wakeword）通常需要服务器进行模型训练，文档中提到预计 10分钟 生效，请耐心等待。
来源：酷虎云api开放平台
