POST/api/global-chatbot/demo/voice-transcribe

将演示页面的语音录音转换为文本（语音转文本），前提是已启用语音功能。此为 widget.voice_transcribe 的演示对应项，固定绑定至 Zentor 营销页面，而非租户小部件。

身份验证与安全

无需身份验证

Origin 检查固定为 https://zentor-app.de / https://www.zentor-app.de（不可配置，在演示路径上替代小部件令牌）。

幂等: 否

参数

visitor_id(body, string，必填)— 必须为有效的 UUID
audio(body, file，必填)— multipart/form-data 音频文件

响应示例

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

错误代码

400 INVALID_VISITOR_ID — visitor_id 缺失或不是有效的 UUID。
403 ORIGIN_DENIED — 请求源不是 zentor-app.de。
413 AUDIO_TOO_LARGE — 音频文件超出限制。
415 AUDIO_TYPE_UNSUPPORTED — 不支持的音频格式。

实时测试证明

失败场景（使用正确 Origin 标头时的 400 INVALID_VISITOR_ID，以及 403 ORIGIN_DENIED）已实时验证。成功场景（真实转录）无法在生产域名之外触发，因为 Origin 检查固定编码为 zentor-app.de——与 widget.voice_transcribe 同样方式记录。

← 演示聊天机器人和单点登录