POST/api/public/widget/voice-transcribe
방문자의 음성 녹음을 텍스트로 변환합니다(Speech-to-Text). 위젯에서 음성 기능이 활성화된 경우에만 해당됩니다.
Auth & Absicherung
Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste
Idempotent: Nein
Parameter
widget_code(body, string, erforderlich)audio(body, binary, erforderlich)— 녹음 데이터를 통한 전사Beispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"음성 기능이 현재 사용 불가능합니다."}}Fehlercodes
400 WIDGET_CODE_REQUIRED — widget_code가 누락되었습니다.503 VOICE_UNAVAILABLE — 이 위젯에서는 언어 기능이 활성화되어 있지 않습니다.Live-Test-Nachweis
음성 기능 비활성화(400 누락된 필드, 503 음성 기능 비활성화) 등 부정적 사례를 실시간으로 검증했습니다. 성공 사례는 실제 오디오와 구성된 음성 인식 제공자를 갖춘 활성화된 음성 위젯이 필요하며, 이는 시뮬레이션되지 않습니다.