[Документация Yandex Cloud](../../index.md) > [speechkit](../index.md) > [Начало работы](index.md) > Как распознать короткие аудиофайлы в API v1

# Как распознать короткие аудиофайлы в SpeechKit


{% note warning %}

[API v1](../stt/api/request-api.md) доступно только в [регионе Россия](../../overview/concepts/region.md). Воспользуйтесь [инструкцией](stt-quickstart-v2.md) для распознавания аудиофайлов в API v3.

{% endnote %}


Сервис позволяет распознавать речь [различными способами](../stt/index.md#stt-ways). В примере ниже аудиофайл распознается с помощью API [синхронного распознавания](../stt/request.md). В этом API действуют ограничения:

* максимальная длительность аудио — 30 секунд;
* максимальный размер файла — 1 МБ.

Чтобы выполнить пример, подготовьте аудиофайл в одном из [поддерживаемых форматов](../formats.md) с учетом указанных выше ограничений.

Для работы с API в примере используется утилита [cURL](https://curl.se/).

## Аутентификация для работы с API {#auth}

Для работы с 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 %}

В примере ниже аутентификация выполняется от имени аккаунта на Яндексе.

## Выполните запрос {#execute}

Отправьте [запрос](../stt/request.md) на распознавание речи:

```bash
export FOLDER_ID=<идентификатор_каталога>
export IAM_TOKEN=<IAM-токен>
curl \
  --request POST \
  --header "Authorization: Bearer ${IAM_TOKEN}" \
  --data-binary "@speech.ogg" \
  "https://stt.api.cloud.yandex.net/speech/v1/stt:recognize?folderId=${FOLDER_ID}&lang=ru-RU"
```

Где:

* `FOLDER_ID` — идентификатор каталога, полученный [ранее](#auth).
* `IAM_TOKEN` — IAM-токен, полученный [ранее](#auth).
* `lang` — [язык](../stt/models.md#languages) распознавания.
* `speech.ogg` – подготовленный ранее аудиофайл с речью.

В ответе сервис вернет распознанный текст, например:

```json
{
   "result":"Я яндекс спичкит я могу превратить любой текст в речь теперь вы можете"
}
```

#### Дополнительная информация {#tutorials}

* [API синхронного распознавания](../stt/api/request-api.md)
* [Пример использования API v1 синхронного распознавания](../stt/api/request-examples.md)
* [API v2 асинхронного распознавания](../stt/api/transcribation-api.md)