VocalStack Logo

Documentation

Transkripsiya Mə'lumatını Al

Göndərilən və ya tamamlanmış transkripsiyalardan məlumatları götür

Mikrofon və ya canlı axından transkript yaz

Mikrofondan ya da canlı axından canlı söhbəti transkriptləşdirin

Transkripsiya

Seanslarla transkripsiya vəziyyətini izləyə və idarə edə bilərsiniz

Tərcümə

Transkripsiya edilmiş mətni başqa dillərə tərcümə et

Audionu URL-dən transkript et

URL-də əvvəlcədən qeyd olunmuş səsdən sadə mətnə səsi transkripsiya et

Transkripsiya İstəyişi və Cavabı

Bütün transkripsiya əməliyyatları üçün ümumi istək seçimləri və cavablar

Polyglot iclasını transkriptləşdir və təqdim et

Əhaliyə açıq paylaşıla bilən bir bağlantı vasitəsilə canlı transkripsiya yaymaq üçün istifadə edilə bilən iclas yaradın

İstifadəçi tərəfi Tanıtma Tokenləri

Mə'lumatı Göstər
Müvəqqəti tanınması token yaratmaq üçün müştəri tərəfi tələbləri. API açarlarınızı açıqlamadan veb brauzerlərdə API istəklərini təhlükəsiz şəkildə yerinə yetirin.
Tanıtma tokenləri VocalStack API xidmətlərinin tələb olunduğu klient mühitinin vacib təhlükəsizlik tədbiridir. Veb brauzerlərində, tətbiqlərdə və ya digər ictimai mühitlərdə API tələblərini yerinə yetirərkən bu tələb olunacaq.
Server tərəfində biz SDK-nı auth tokenini yaratmaq üçün istifadə edə bilərik. Ön qurğulu olaraq, token seçimləri məhdudlaşdırıcıdır. Siz bunları öz tələblərinizə uyğun olaraq yeniləmək istəyəcəksiniz:
  • access: Ya "readonly" ya da "readwrite". İlki sizə məlumatı geri qaytaran API çağırışlarını yerinə yetirməyə imkan verir. Sonrakı sizə hesablanacaq transkripsiya ilə əlaqəli əməliyyatları da ehtiva edən API tələblərini yerinə yetirməyə imkan verir. Bu seçim üçün ön qurğulu dəyər "onlyread".
  • lifetime_s: 1 ilə 120 arasında bir ədəd, saniyədə tokenin ömrünü təmsil edir. Bu müddətdən sonra tokenin müddəti bitəcək və daha istifadə edilə bilməyəcək. Bu işarə ilə artıq başlanmış async istəklərinə təsir etməyəcəyini nəzərə alın. (Digər sözlə, bir dəfə async tələbi başladıqdan sonra, o, istək başladıqdan sonra tokenin vaxtı bitsə belə, tamamlanana qədər davam edəcək. ) Bu seçim üçün ön qurğulu dəyər : 10-cu.
  • one_time: Bu API tokenin tək istifadə üçün nəzərdə tutulduğunu bildirən bir boolean. Əgər doğrudursa, bu token API tələbi üçün istifadə edildikdən sonra, o, vaxtından əvvəl bitəcəkdir. Bu seçim üçün ön qurğulu dəyər doğru.
Vericinizdə bu necə görünəcək:
JavaScript
import { Security } from '@vocalstack/js-sdk'; const sdk = new Security({ apiKey: 'YOUR-API-KEY' }); const authToken = await sdk.generateToken({ access: 'readwrite', // Optional: 'readonly' or 'readwrite' lifetime_s: 60, // Optional: 1-120 seconds one_time: true, // Optional: true or false }); // Next, return the token to the client where API request will be made. // Make sure to keep the token secure and do not expose it to the public.
Siz serveriniz tərəfindən yaradılan API tokenini müştərinizə xidmət etmək üçün bir mexanizm qurmalısınız. Bu, infrastrukturunuzun və texnoloji stack-inizin böyüklüyünə bağlı olacaq. Təhlükəsizlik ən yaxşı praktikasını tətbiq etdiyinizə əmin olun. Məsələn, təsdiqlənməmiş tələblərə yaradılmış API tokenləri xidmət edən bir API son nöqtəsi yaratmamalısınız.
VocalStack API-ni müştəri tərəfində istifadə etmək üçün authToken setting instead of an apiKey. Məsələn, Audionu URL-dən transkript et üçün sənədləşdirməni nəzərdən keçirin.
Bu nümunədə sadəcə olaraq dəyişdir:
{ apiKey: 'YOUR-API-KEY' } ilə { authToken: 'YOUR-AUTH-TOKEN' } 6. səh.
JavaScript
import { UrlTranscription } from '@vocalstack/js-sdk'; const authToken = await fetch('http://example.com/your-secured-api/authenticate') .then((response) => response.json()) .then((data) => data.token); const sdk = new UrlTranscription({ authToken }); const transcription = await sdk.connect({ url: 'http://example.com/speech.mp3' }); transcription.start();
Klient tərəfi təsdiqləmə tokenlərini yaratmaq və xidmət göstərmək üçün, API-nizə icazəsiz girişi qarşısını almaq üçün sərt təhlükəsizlik tədbirlərini tətbiq etmək vacibdir. Tokenlər resurslara və xidmətlərə çıxış üçün güclü alətlərdir və əgər qorunmasalar, onlar səhv istifadə edilə bilər. Yalnız icazəli müştərilərin tokenləri istəyib istifadə edə biləcəyinizə əmin olmalısınız və API açarları kimi həssas məlumatları ictimai mühitə heç vaxt açmamalısınız. Bunu etməmək məlumat pozuntularına, resurslara icazəsiz çıxışa və ya ödəniş xidmətləri üçün qeyri-müəyyən ödənişlərə səbəb ola bilər.
İcranın təhlükəsizliyinə kömək etmək üçün aşağıdakı ən yaxşı təcrübələri nəzərə alın:
  • API açarlarınızı heç vaxt müştəri tərəfində göstərmə: API açarları hər zaman gizli qalmalıdır və serverdə təhlükəsiz saxlanmalıdır. Onları müştəri tərəfi kodunda (e. d JavaScript, HTML) API-yə icazəsiz girişə səbəb ola bilər.
  • Təhlükəsiz Verici tərəfi Token Yaratmasını İstifadə Et: Always generate authentication tokens on the server side to prevent exposure of API keys in client code.
  • Tokenlər üçün Tanıtma İstəyişi: Təsdiqləmə mexanizmlərini tətbiq etməklə yalnız təsdiqlənmiş istifadəçilər və ya xidmətlər API tokenini tələb edə bilər (e. d , OAuth, sessiya təsdiqi).
  • HTTPS-i tətbiq et: Always serve tokens over HTTPS to protect against man-in-the-middle attacks (azərb.
  • Ünvanlarda Tokenləri Göstərməməyi Tə'min Et: URL sorğu parametrlərində heç vaxt tokenlər verməyin, çünki onlar server loglarında ya da brauzer tarixində aşkar edilə bilər.
  • _Token: Tokenləri minimum lazımi icazələrə məhdudlaşdırın, məsələn, yalnız oxumaq üçün giriş, yazılması açıq şəkildə tələb olunmadığı təqdirdə.
  • Tokenin sonunu təyin et: Tokenin səhv istifadəsi riskini azaltmaq üçün qısa token həyat müddətlərini istifadə edin. Token həyat müddətini istifadə nümunələri və təhlükəsizlik ehtiyaclarına əsaslanaraq məhdudlaşdırmağı düşünün.
  • Bir dəfə istifadə olunan tokeni fəallaşdır: Əgər mümkündürsə, xüsusilə həssas hərəkətlər üçün bir dəfəlik tokenlərdən istifadə edin ki, onlar yenidən istifadə edilməsin.
Scroll Up