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

# Синтез речи из текста в формате SSML с помощью API v1


{% note info %}

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

{% endnote %}


С помощью [API v1](../request.md) можно синтезировать речь из текста, размеченного по правилам [SSML](../markup/ssml.md), в файл формата [OggOpus](../../formats.md).

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

* [язык](../index.md#langs) — русский;
* [голос](../voices.md) — `jane`;
* остальные параметры оставлены по умолчанию.

Считывание текстового файла выполняется с помощью утилиты [cat](https://ru.wikipedia.org/wiki/Cat).

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

{% list tabs group=programming_language %}

- Bash {#bash}

  1. Создайте файл, например `text.xml`, и напишите в нем текст в формате SSML:

     ```xml
     <speak>
       Вот несколько примеров использования SSML.
       Вы можете добавить в текст паузу любой длины:<break time="2s"/> та-дааам!
       Или разметить текст на параграфы и предложения. Паузы между параграфами длиннее.
       <p><s>Первое предложение</s><s>Второе предложение</s></p>
       А еще вы можете подменять фразы.
       Например, чтобы произносить аббревиатуры и <sub alias="тому подобное">т.п.</sub>
     </speak>
     ```

  1. Отправьте запрос с текстом на сервер:

     ```bash
     export FOLDER_ID=<идентификатор_каталога>
     export IAM_TOKEN=<IAM-токен>
     curl \
       --request POST \
       --header "Authorization: Bearer ${IAM_TOKEN}" \
       --data-urlencode "ssml=`cat text.xml`" \
       --data "lang=ru-RU&voice=jane&folderId=${FOLDER_ID}" \
       "https://tts.api.cloud.yandex.net/speech/v1/tts:synthesize" > speech.ogg
     ```

     Где:

     * `FOLDER_ID` — [идентификатор каталога](../../../resource-manager/operations/folder/get-id.md).
     * `IAM_TOKEN` — [IAM-токен](../../../iam/concepts/authorization/iam-token.md).
     * `ssml` — файл с текстом, размеченным по правилам [SSML](../markup/ssml.md).
     * `lang` — [язык](../index.md#langs) текста.

  Синтезированная речь будет записана в файл `speech.ogg` в папке, из которой вы отправляли запрос.

{% endlist %}

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

* [Описание метода API v1](../request.md)
* [Синтез речи в формате WAV с помощью API v1](tts-wav.md)
* [Синтез речи в формате OggOpus с помощью API v1](tts-ogg.md)
* [Аутентификация в API SpeechKit](../../concepts/auth.md)