Разметка SSML

Использование Speech Synthesis Markup Language (SSML) дает вам возможность контролировать, как SpeechKit синтезирует речь из текста.

Поддержка SSML доступна только при использовании API v1.

Чтобы передать текст в формате SSML, используйте параметр ssml в теле запроса, а сам текст оберните в тег <speak>:

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

Пример отправки запроса.

Поддерживаемые теги SSMLПоддерживаемые теги SSML

На данный момент SpeechKit поддерживает следующие теги SSML:

breakbreak

Используйте тег <break>, чтобы добавить в речь паузу заданной длительности. Длительность указывается с помощью атрибутов strength и time. Если эти атрибуты не заданы, то по умолчанию используется strength="medium".

<speak>Эй, секундочку<break time="1s"/> Что вы делаете?</speak>

Тег <break> добавляет паузу, даже если он идет после других элементов, добавляющих паузу, например после точки или запятой.

pp

Используйте тег <p>, чтобы добавить паузу между абзацами. Пауза добавляется после закрывающего тега.

Пауза после абзаца больше, чем пауза после предложения или точки. Длительность паузы зависит от выбранного голоса, эмоциональной окраски, скорости и языка.

<speak>
  <p>Палач доказывал, что нельзя отрубить голову, у которой нет туловища, значит казнь не может состояться.</p>
  <p>Король доказывал, что все, имеющее голову, может быть обезглавлено, и что палач говорит пустяки.</p>
  <p>Королева тем временем вопила, что если кот не будет немедленно казнен, то казнены будут все присутствующие (замечание это удручающе подействовало на всех участников игры).</p>
</speak>

Все паузы внутри тега тоже учитываются. Например, на месте точки добавится дополнительная пауза, даже если она стоит перед закрывающим тегом.

phonemephoneme

Используйте тег <phoneme>, чтобы контролировать правильность произношения с помощью фонем. Для воспроизведения будет использован текст, указанный в атрибуте ph. В атрибуте alphabet укажите используемый стандарт: ipa или x-sampa.

• Международный фонетический алфавит (IPA)

  <speak>
        В разных регионах России по-разному произносят букву
        <phoneme alphabet="ipa" ph="o">О</phoneme> в словах.
        Где-то говорят <phoneme alphabet="ipa" ph="məlɐko">молоко</phoneme>,
        а где-то <phoneme alphabet="ipa" ph="mələko">молоко</phoneme>.
  </speak>
  

• Extended Speech Assessment Methods Phonetic Alphabet (X-SAMPA)

  <speak>
        В разных регионах России по-разному произносят букву
        <phoneme alphabet="x-sampa" ph="o">О</phoneme> в словах.
        Где-то говорят <phoneme alphabet="x-sampa" ph="m@l6ko">молоко</phoneme>,
        а где-то <phoneme alphabet="x-sampa" ph="m@l@ko">молоко</phoneme>.
  </speak>
  

Список поддерживаемых фонем.

speakspeak

Тег <speak> — это корневой тег. Весь текст должен быть внутри этого тега.

<speak>Мой текст в формате SSML.</speak>

ss

Используйте тег <s>, чтобы добавить паузу между предложениями. Пауза после предложения равна паузе после точки. Длительность паузы зависит от выбранного голоса, эмоциональной окраски, скорости и языка.

<speak>
  <s>Первое предложение</s>
  <s>Второе предложение</s>
</speak>

Все паузы внутри тега тоже учитываются. Например на месте точки добавится дополнительная пауза, даже если она стоит перед закрывающим тегом.

subsub

Используйте тег <sub>, чтобы подменить текст на другой текст при произношении. Например, чтобы правильно произнести аббревиатуру или название химического элемента.

<speak>
  Мой любимый химический элемент — <sub alias="ртуть">Hg</sub>, потому что блестит.
</speak>

Примеры использованияПримеры использования

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