Аутентификация в API SpeechKit

Статья создана

Обновлена 7 марта 2025 г.

Для работы с API SpeechKit пройдите аутентификацию. Ее способ зависит от типа аккаунта:

Аккаунт на Яндексе или федеративный аккаунт

Сервисный аккаунт

Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта.
Получите идентификатор каталога, на который у вашего аккаунта есть роли ai.speechkit-stt.user, ai.speechkit-tts.user или выше.
При обращении к SpeechKit через API в каждом запросе передавайте полученные параметры:
- Для API v1 и API v2:
  
  Указывайте IAM-токен в заголовке Authorization в следующем формате:
```
Authorization: Bearer <IAM-токен>
```
  Идентификатор каталога указывайте в теле запроса в параметре folderId.
- Для API v3:
  - в заголовке Authorization указывайте IAM-токен;
  - в заголовке x-folder-id указывайте идентификатор каталога.
```
Authorization: Bearer <IAM-токен> 
x-folder-id <идентификатор_каталога>
```

SpeechKit поддерживает два способа аутентификации с сервисным аккаунтом:

Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.