POST/api/public/widget/voice-speak

위젯에서 음성 출력을 위해 텍스트를 음성으로 변환(Text-to-Speech)합니다. 활성화된 경우에만 적용됩니다.

Auth & Absicherung

위젯 임베드 토큰(X-Widget-Token 헤더) + Origin 허용 목록

Idempotent: Ja

Parameter

widget_code(body, string, erforderlich)
text(body, string, 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)는 POST 요청에 대해 실시간으로 검증되었습니다. 동일한 경로의 GET 버전도 존재하며(자동 추출에 따르면 동일한 동작), 별도로 다시 테스트하지는 않았습니다.

← 채팅 위젯