POST/api/global-chatbot/demo/voice-transcribe
デモページの音声録音をテキストに変換します(Speech-to-Text)。言語が有効になっている場合にのみ実行されます。widget.voice_transcribeのデモ版であり、テナントウィジェットではなく、Zentorマーケティングページに固定されています。
Auth & Absicherung
Keine Authentifizierung erforderlich
Origin-Pruefungはhttps://zentor-app.de / https://www.zentor-app.deに固定されています(設定不可、デモパスにおけるWidgetトークンの代替)。
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 — リクエストのOriginはzentor-app.deではありません。413 AUDIO_TOO_LARGE — オーディオファイルが制限を超えています。415 AUDIO_TYPE_UNSUPPORTED — オーディオ形式はサポートされていません。Live-Test-Nachweis
ネガティブケース(正しいOriginヘッダー付きの400 INVALID_VISITOR_ID、403 ORIGIN_DENIED)はライブで検証済み。成功ケース(実際のトランスクリプション)は、Originチェックがzentor-app.deにハードコードされているため、本番ドメイン外ではトリガーできません。これはwidget.voice_transcribeで文書化されているのと同様です。