POST/api/global-chatbot/demo/voice-speak
यदि सक्षम छ भने, डेमो पृष्ठमा भाषा आउटपुटको लागि पाठलाई बोल्ने भाषामा रूपान्तरण गर्दछ (Text-to-Speech) ।
`POST /api/global-chatbot/demo/voice-speak` ले डेमोका लागि भाषा सुविधा सक्रिय भएमा पाठलाई बोलिने भाषामा रूपान्तरण गर्छ। यो एन्डपोइन्ट सार्वजनिक डेमो पृष्ठले प्रयोग गर्छ र स्वतन्त्र रूपमा प्रयोग गर्न मिल्ने सामान्य Text-to-Speech API का रूपमा परिकल्पित छैन। ड्यासबोर्ड प्रमाणीकरण आवश्यक पर्दैन, तर `https://zentor-app.de` र `https://www.zentor-app.de` का लागि निश्चित Origin जाँच लागू हुन्छ। Request मा बोलिनुपर्ने पाठ र दस्ताबेजीकृत स्किमामा तोकिएका भाषा विकल्पहरू समावेश हुन्छन्। क्लाइन्टले वास्तवमा डेमो संवादमा बोलिनुपर्ने पाठ मात्र पठाउनुपर्छ। खाली इनपुट, अमान्य ढाँचा वा सक्रिय नगरिएको भाषा सुविधालाई त्रुटिका रूपमा व्यवस्थापन गर्नुपर्छ। Origin लाई स्थानीय रूपमा परिवर्तन गर्ने वा फरक डोमेनबाट कल गर्ने कार्यले सर्भर-साइड जाँचलाई बाइपास गर्दैन। यो अपरेसनले अडियो उत्पन्न गर्छ र त्यसैले यसलाई आइडेम्पोटेन्ट शुद्ध पठन अपरेसनका रूपमा हेर्नु हुँदैन। उही पाठ पटक-पटक पठाउँदा धेरै प्रशोधन प्रक्रिया चल्न सक्छ। डेमो इन्टरफेसले प्रशोधनको क्रममा आउटपुट बटन निष्क्रिय गर्नुपर्छ र नयाँ प्लेब्याक सुरु गर्नुअघि चलिरहेको प्लेब्याक सफा तरिकाले रोक्नुपर्छ। एउटा यथार्थपरक प्रवाह डेमोमा बोटको प्रतिक्रियाबाट सुरु हुन्छ। प्रयोगकर्ताले भाषा आउटपुट सक्रिय गर्छ, पृष्ठले प्रतिक्रिया पाठलाई `voice-speak` मा पठाउँछ, अडियो डेटा वा दस्ताबेजीकृत अडियो प्रतिक्रिया प्राप्त गर्छ र त्यसलाई ब्राउजरमा बजाउँछ। अनुमति नपाएको Origin का कारण अनुरोध असफल भएमा, इन्टरफेसले कुनै पनि अन्य विकल्प सेवालाई कल गर्नु हुँदैन, बरु भाषा सुविधा उपलब्ध नभएको देखाउनुपर्छ। पासवर्ड, टोकन वा गोप्य सामग्री Request मा राख्नु हुँदैन। डेमो च्यानल सार्वजनिक हो र गोप्य कम्पनी डेटाका लागि होइन। अडियो प्रतिक्रियाहरू पनि सार्वजनिक लगमा स्थायी रूपमा भण्डारण गर्नु हुँदैन। यो एन्डपोइन्ट प्राविधिक रूपमा SIP-Voicebot बाट अलग छ। टेलिफोनी प्रत्येक ग्राहकका लागि अलग-थलग SIP इन्स्टेन्समा चल्छ र त्यो केवल Master Admin ले नै सक्रिय गर्छ; `voice-speak` ले कुनै फोन नम्बर नियन्त्रण गर्दैन र कुनै फोन कल सुरु गर्दैन। पहुँचयोग्यताका लागि, डेमोले अडियो आउटपुटसँगै सधैं पूर्ण पाठ पनि देखाउनुपर्छ। भाषा आउटपुटमा दृश्य रूपमा नभएको कुनै जानकारी हुनु हुँदैन। ब्राउजरहरूले प्रयोगकर्ता अन्तरक्रिया नभएसम्म प्लेब्याक रोक्न सक्छन्; त्यसैले सुरुआत जानाजानी क्लिकबाट नै गराउनुपर्छ। रोक्ने र फेरि बजाउने कार्य नियन्त्रित रूपमा सम्भव हुनुपर्छ।
Auth & Absicherung
प्रमाणीकरण आवश्यक छैन
मूल परीक्षण https://zentor-app.de / https://www.zentor-app.de मा स्थिर (कन्फिगर गर्न सकिदैन, डेमो पथमा विजेट टोकनहरूको लागि प्रतिस्थापन) ।
Idempotent: Ja
Parameter
visitor_id(body, string, erforderlich)— एक मान्य UUID हुनु पर्छtext(body, string, erforderlich)— भाषामा रूपान्तरण गर्न पाठBeispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id हराइरहेको छ वा कुनै मान्य UUID छैन।403 ORIGIN_DENIED — अनुरोध उत्पत्ति केन्द्र-app.de होइन।503 VOICE_UNAVAILABLE — भाषा सुविधा अहिले उपलब्ध छैन।Live-Test-Nachweis
नकारात्मक अवस्थामा (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, प्रत्येक सही मूल-हेडर संग) प्रत्यक्ष प्रमाणित। एउटै बाटो को GET संस्करण पनि अवस्थित छ (देशी <अडियो src>-प्रवाह, समान व्यवहार) । Demo-Pendant widget.voice_speak.