[Документация Yandex Cloud](../../index.md) > [speechkit](../index.md) > Справочники API > Аутентификация в API

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


{% note info %}

В [регионе Казахстан](../../overview/concepts/region.md) доступна только версия API v3.

{% endnote %}


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

{% list tabs group=authentication %}

- Аккаунт на Яндексе, федеративный или локальный аккаунт {#yandex-account}

  1. Получите IAM-токен для [аккаунта на Яндексе](../../iam/operations/iam-token/create.md), [федеративного](../../iam/operations/iam-token/create-for-federation.md) или [локального](../../iam/operations/iam-token/create-for-local.md) аккаунта.
  1. Получите [идентификатор каталога](../../resource-manager/operations/folder/get-id.md), на который у вашего аккаунта есть роли `ai.speechkit-stt.user`, `ai.speechkit-tts.user` или выше.
  1. При обращении к 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: <идентификатор_каталога>
        ```

- Сервисный аккаунт {#service-account}

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

   * С помощью [IAM-токена](../../iam/concepts/authorization/iam-token.md):

      1. [Получите IAM-токен](../../iam/operations/iam-token/create-for-sa.md).
      1. Полученный IAM-токен передавайте в заголовке `Authorization` в следующем формате:

          ```yaml
          Authorization: Bearer <IAM-токен>
          ```

   * С помощью [API-ключей](../../iam/concepts/authorization/api-key.md).

     Используйте API-ключи, если у вас нет возможности автоматически запрашивать [IAM-токен](../../iam/concepts/authorization/iam-token.md).

      1. [Получите API-ключ](../../iam/operations/authentication/manage-api-keys.md#create-api-key).
      1. Полученный API-ключ передавайте в заголовке `Authorization` в следующем формате:

          ```yaml
          Authorization: Api-Key <API-ключ>
          ```

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

{% endlist %}

#### Полезные ссылки {#see-also}

* [Аккаунты в Yandex Cloud](../../iam/concepts/users/accounts.md)
* [Какие роли необходимы для выполнения операций](../security/index.md)