[Документация Yandex Cloud](../../../index.md) > [speechkit](../../index.md) > Пошаговые инструкции > Синтез > Синтез речи в REST API v3

# Синтез речи в API v3 REST

SpeechKit REST API v3 можно использовать для синтеза речи, если вам не нужны преимущества gRPC API.

В примере заданы следующие параметры синтеза:

* [голос](../voices.md) — `marina`
* амплуа — `friendly` (дружелюбная)
* формат аудио — WAV (значение по умолчанию)

Аутентификация происходит от имени аккаунта на Яндексе или федеративного аккаунта с использованием [IAM-токена](../../../iam/concepts/authorization/iam-token.md). Для аутентификации необходим идентификатор каталога, в котором у пользователя есть роль `ai.speechkit-tts.user` [для работы с сервисом SpeechKit](../../security/index.md). Если вы используете сервисный аккаунт, передавать в запросе идентификатор каталога не нужно. Подробнее об аутентификации в API SpeechKit смотрите [Аутентификация в API SpeechKit](../../concepts/auth.md).

{% list tabs group=programming_language %}

- cURL {#curl}

  Чтобы повторить пример, потребуется утилита [jq](https://github.com/jqlang/jq) для работы с файлами JSON.

  1. Создайте файл `request.json` с параметрами запроса:

      ```json
      {"text": "Привет! Я Яндекс Спичк+ит. Я могу превратить любой текст в речь. Теперь и в+ы - можете!", "hints": [{"voice": "marina"}, {"role": "friendly"}]}
      ```

      Где:
      * `text` — синтезируемый текст;
      * `hints` — список параметров синтеза:
          * `voice` — голос для синтеза
          * `role` — амплуа

  1. В терминале выполните запрос, указав IAM-токен и идентификатор каталога, который вы будете использовать для работы с SpeechKit:

      ```bash
      export FOLDER_ID=<идентификатор_каталога>
      export IAM_TOKEN=<IAM-токен>

      curl \
        --header "Authorization: Bearer $IAM_TOKEN" \
        --header "x-folder-id: $FOLDER_ID" \
        --data @request.json https://tts.api.ml.yandexcloud.kz:443/tts/v3/utteranceSynthesis | \
        jq -r  '.result.audioChunk.data' | \
        while read chunk; do base64 -d <<< "$chunk" >> audio.wav; done
      ```

     Где:
     * `FOLDER_ID`— [идентификатор каталога](../../../resource-manager/operations/folder/get-id.md), на который у вашего аккаунта есть роль `ai.speechkit-tts.user` или выше. Если вы используете сервисный аккаунт, передавать в запросе идентификатор каталога не нужно.
     * `IAM_TOKEN` — IAM-токен вашего [аккаунта на Яндексе](../../../iam/operations/iam-token/create.md) или [федеративного аккаунта](../../../iam/operations/iam-token/create-for-federation.md).

     Синтезированная речь вернется в кодировке Base64 и будет записана в файл `audio.wav`.

{% endlist %}