Қолжетімділік токенін алу

Токен мыналар үшін беріледі:

• аудиофайлдарды тану;
• ағындық аудионы тану;
• сөйлеуді синтездеу.

Токен алудың екі тәсілі бар:

1. OAuth — бұл артықшылық берілетін сценарий, өйткені онда токенді жаңарту механизмі (refresh token) іске асырылған.

2. Сервистік токен — артықшылығы төмен сценарий. Токен бір рет беріледі және уақыт бойынша шектеусіз жұмыс істей алады. Егер сервистік токен әшкереленсе, қаскүнем сервисті шектеусіз пайдалана алады, бұл үлкен шығындарға әкеледі. Дербес шоттағы қаражат таусылған кезде сервис тоқтатылады.

Токенді генерациялауға арналған сұрау мысалы:

 
curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token' \--header 'Content-Type: application/json' \--data '{"client_id":"mcs5719255887.voice.6Wg9D18XPZN28DWy4wEba","client_secret": "1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ","grant_type":"client_credentials"}'

Жауап мысалы:

 
{  "refresh_token": "<ЗНАЧЕНИЕ_ОБНОВЛЯЮЩЕГО_ТОКЕНА>",  "access_token": "<ЗНАЧЕНИЕ_ТОКЕНА_ДОСТУПА>",  "expired_in": "3600",  "scope": {    "tts": 1,    "asr_short": 1,    "asr_stream": 1  }}

Серверден жауап ретінде сіз 2 токен аласыз:

• access_token — қолжетімділік токені (бір сағаттан кейін жарамсыз болады);
• refresh_token — қолжетімділік токенін жаңартуға арналған токен.

Токенді жаңартуға арналған сұрау мысалы:

 
curl -X POST --location 'https://mcs.mail.ru/auth/oauth/v1/token' \--header 'Content-Type: application/json' \--data '{"client_id":"mcs5719255887.voice.6Wg9D18XPZN28DWy4wEba","refresh_token":"ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890","grant_type":"refresh_token"}'

Жауап мысалы:

 
{  "refresh_token": "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890",  "access_token": "23wcTiUeaa334Uv6TH3StRGiZBMCyyo1Hzgqqa3n",  "expired_in": "3600",  "scope": {    "tts": 1,    "asr_short": 1,    "asr_stream": 1  }}

Жобада бір мезетте 25 белсенді refresh_token дейін болуы мүмкін, олардың әрқайсысына әр сәтте 25 access_token байланыстырылуы мүмкін.

Сервистік токенді алу үшін:

1. VK Cloud жеке кабинетінде AI API → Cloud Voice бөліміне өтіңіз.
2. Сервистік токен қосу түймесін басыңыз.
3. Ашылған терезеде қажетті параметрлерді көрсетіп, Жасау түймесін басыңыз.

Алынған қолжетімділік токенін барлық HTTP сұрауларында Bearer Token пішімінде жіберу қажет.

Сөйлеуді тану

Сөйлеуді синтездеу