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 语音功能未启用)已实时验证。成功场景需要一个已启用语音的小部件、真实音频以及已配置的语音识别提供商——未复现。