POST/api/public/widget/voice-transcribe

若该小部件已启用语音功能,则将访客的语音录音转换为文本(语音转文本)。

身份验证与安全

组件嵌入令牌(请求头 X-Widget-Token)+ 来源(Origin)许可列表

幂等: 否

参数

widget_code(body, string,必填)
audio(body, binary,必填)— 用于转录的音频数据

响应示例

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

错误代码

400 WIDGET_CODE_REQUIRED — widget_code 缺失。
503 VOICE_UNAVAILABLE — 此小部件未启用语音功能。

实时测试证明

失败场景(400 字段缺失、503 语音功能未启用)已实时验证。成功场景需要一个已启用语音的小部件、真实音频以及已配置的语音识别提供商——未复现。

← 聊天小部件