POST/api/global-chatbot/demo/voice-speak
পাঠ্যকে কথ্য ভাষায় রূপান্তর করে (টেক্সট-টু-স্পিচ) ডেমো পৃষ্ঠায় ভাষা আউটপুটের জন্য, যদি সক্রিয় থাকে।
`POST /api/global-chatbot/demo/voice-speak` টেক্সটকে কথ্য ভাষায় রূপান্তর করে, যদি ডেমোর জন্য ভয়েস ফিচার সক্রিয় থাকে। এই এন্ডপয়েন্টটি পাবলিক ডেমো পেজ দ্বারা ব্যবহৃত হয় এবং এটি একটি মুক্তভাবে ব্যবহারযোগ্য সাধারণ টেক্সট-টু-স্পিচ API হিসেবে উদ্দিষ্ট নয়। ড্যাশবোর্ড প্রমাণীকরণের প্রয়োজন নেই, তবে `https://zentor-app.de` এবং `https://www.zentor-app.de`-এর জন্য একটি নির্দিষ্ট অরিজিন যাচাই প্রযোজ্য। রিকোয়েস্টে উচ্চারণযোগ্য টেক্সট এবং নথিভুক্ত স্কিমায় নির্ধারিত ভাষার বিকল্পগুলি অন্তর্ভুক্ত থাকে। ক্লায়েন্টের শুধুমাত্র সেই টেক্সট পাঠানো উচিত যা প্রকৃতপক্ষে ডেমো ডায়ালগে বলা হবে। খালি ইনপুট, অবৈধ ফরম্যাট বা অ-সক্রিয় ভয়েস ফিচারকে ত্রুটি হিসেবে গণ্য করতে হবে। অরিজিনের স্থানীয় পরিবর্তন বা বিদেশী ডোমেইন থেকে কল করলে সার্ভার-সাইড যাচাই এড়ানো যায় না। এই অপারেশনটি অডিও তৈরি করে, তাই এটি একটি আইডেমপোটেন্ট বিশুদ্ধ রিড অপারেশন হিসেবে বিবেচিত নয়। একই টেক্সট একাধিকবার পাঠালে একাধিক প্রসেসিং অপারেশন ট্রিগার হতে পারে। ডেমো ইন্টারফেসের প্রসেসিং চলাকালীন আউটপুট বোতামটি নিষ্ক্রিয় করা উচিত এবং নতুন প্লেব্যাক শুরু করার আগে চলমান প্লেব্যাক সঠিকভাবে বন্ধ করা উচিত। একটি বাস্তবসম্মত প্রক্রিয়া ডেমোতে একটি বট-উত্তর দিয়ে শুরু হয়। ব্যবহারকারী স্পিচ আউটপুট সক্রিয় করে, পৃষ্ঠাটি উত্তর টেক্সটটি `voice-speak`-এ পাঠায়, অডিও ডেটা বা নথিভুক্ত অডিও উত্তর পায় এবং ব্রাউজারে তা চালায়। যদি অনুমোদিত নয় এমন অরিজিনের কারণে অনুরোধটি ব্যর্থ হয়, তাহলে ইন্টারফেসটি কোনো ইচ্ছামতো বিকল্প পরিষেবা কল করতে পারবে না, বরং স্পিচ ফাংশনটি অনুপলব্ধ হিসাবে প্রদর্শন করা উচিত। পাসওয়ার্ড, টোকেন বা গোপনীয় বিষয়বস্তু রিকোয়েস্টে থাকা উচিত নয়। ডেমো চ্যানেলটি সর্বজনীন এবং গোপন কোম্পানির ডেটার জন্য নয়। অডিও উত্তরগুলিও স্থায়ীভাবে সর্বজনীন লগে সংরক্ষণ করা উচিত নয়। এন্ডপয়েন্টটি প্রযুক্তিগতভাবে SIP-Voicebot থেকে পৃথক। টেলিফোনি প্রতিটি টেন্যান্টের জন্য বিচ্ছিন্ন SIP-ইনস্ট্যান্সে চলে এবং শুধুমাত্র মাস্টার অ্যাডমিন দ্বারা সক্রিয় করা হয়; `voice-speak` কোনো ফোন নম্বর নিয়ন্ত্রণ করে না এবং কোনো ফোন কল শুরু করে না। অ্যাক্সেসিবিলিটির জন্য, ডেমোটি অডিও আউটপুটের পাশাপাশি সর্বদা সম্পূর্ণ পাঠ্য প্রদর্শন করবে। স্পিচ আউটপুটে এমন কোনো তথ্য থাকা উচিত নয় যা দৃশ্যত অনুপস্থিত। ব্রাউজারগুলি ততক্ষণ প্লেব্যাক ব্লক করতে পারে যতক্ষণ না ব্যবহারকারীর ইন্টারঅ্যাকশন হয়; তাই শুরুটি সচেতনভাবে একটি ক্লিকের মাধ্যমে ট্রিগার করা উচিত। বাতিল এবং পুনরায় প্লেব্যাক নিয়ন্ত্রিতভাবে সম্ভব হতে হবে।
Auth & Absicherung
Keine Authentifizierung erforderlich
Origin-পরীক্ষা স্থিরভাবে 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":"ভয়েস ফাংশন বর্তমানে উপলব্ধ নয়।"}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id অনুপস্থিত বা এটি একটি বৈধ UUID নয়।403 ORIGIN_DENIED — অনুরোধের উত্স zentor-app.de নয়।503 VOICE_UNAVAILABLE — ভাষা ফাংশনটি বর্তমানে উপলব্ধ নয়।Live-Test-Nachweis
নেতিবাচক কেস (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, প্রতিটি সঠিক Origin-Header সহ) লাইভ যাচাই করা হয়েছে। একই পাথের GET-ভ্যারিয়েন্টও বিদ্যমান (নেটিভ <audio src>-স্ট্রিমিং, অভিন্ন আচরণ)। widget.voice_speak-এর ডেমো প্রতিরূপ।