POST/api/global-chatbot/demo/voice-transcribe
데모 페이지의 음성 오디오 녹음을 텍스트로 변환합니다(음성 인식). widget.voice_transcribe의 데모 버전으로, Tenant 위젯이 아닌 Zentor 마케팅 페이지에 고정되어 있습니다.
Auth & Absicherung
Keine Authentifizierung erforderlich
Origin-Pruefung은 https://zentor-app.de / https://www.zentor-app.de에 고정되어 있습니다(구성 불가, Demo 경로에서 위젯 토큰 대체용).
Idempotent: Nein
Parameter
visitor_id(body, string, erforderlich)— 유효한 UUID여야 합니다audio(body, file, erforderlich)— multipart/form-data 오디오 파일Beispiel-Response
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id는 유효한 UUID여야 합니다."}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id가 누락되었거나 유효한 UUID가 아닙니다.403 ORIGIN_DENIED — 요청 원본이 zentor-app.de가 아닙니다.413 AUDIO_TOO_LARGE — 오디오 파일이 제한을 초과했습니다.415 AUDIO_TYPE_UNSUPPORTED — 오디오 형식이 지원되지 않습니다.Live-Test-Nachweis
음성 인식 실패 사례(400 INVALID_VISITOR_ID 및 올바른 Origin 헤더, 403 ORIGIN_DENIED)는 실시간으로 확인되었습니다. 성공 사례(실제 전사)는 프로덕션 도메인 외부에서는 발생하지 않습니다. 이는 Origin 검증이 zentor-app.de에 고정되어 있기 때문입니다. 이는 widget.voice_transcribe에 문서화된 내용과 유사합니다.