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

在語音功能已啟用時，將示範頁面的語音錄音轉換為文字（語音轉文字）。此為 widget.voice_transcribe 的示範對應版本，固定綁定 Zentor 市場推廣網站，而非租戶小工具。

身份驗證同安全保障

唔需要身份驗證

來源檢查固定為 https://zentor-app.de / https://www.zentor-app.de（不可設定，在示範路徑上代替小工具 Token）。

冪等: 唔係

參數

visitor_id(body, string，必填)— 必須為有效的 UUID
audio(body, file，必填)— multipart/form-data 音訊檔案

回應範例

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id 必須係一個有效嘅 UUID。"}}

錯誤代碼

400 INVALID_VISITOR_ID — visitor_id 遺失或並非有效 UUID。
403 ORIGIN_DENIED — 請求來源並非 zentor-app.de。
413 AUDIO_TOO_LARGE — 音訊檔案超出限制。
415 AUDIO_TYPE_UNSUPPORTED — 不支援音訊格式。

即時測試證明

負例（400 INVALID_VISITOR_ID 配正確 Origin 標頭，403 ORIGIN_DENIED）已實時驗證。成功例（真實轉錄）無法在非生產環境觸發，因 Origin 檢查已固定編碼為 zentor-app.de——此設定與 widget.voice_transcribe 文件一致。

← 示範聊天機器人同 SSO