ym88659208ym87991671
Использование SSML-разметки для синтеза речи с помощью сервиса SaluteSpeech | Документация для разработчиков

Как улучшить синтез с SSML-разметкой

Обновлено 17 июля 2025

SSML (Speech Synthesis Markup Language) — язык разметки синтеза речи. Позволяет настраивать преобразование текста в речь и делает речь более естественной и выразительной.

SSML базируется на спецификации от W3C .

Доступные функции

Также для синтезируемого текста внутри SSML-разметки поддерживаются различные символы. Подробнее — в разделе Символы и междометия.

Применение SSML-разметки в зависимости от языка синтеза

Поддержка SSML-разметки зависит от выбранного языка синтеза. Некоторые теги доступны только для русского языка или работают с ограничениями на других языках.

Описание тегаНаименование тега
Русский язык 
Создание шаблона для аудиозаписи<template id>ДаНет
Паузы в тексте<break>ДаДа
Исправление произношения<sub alias>ДаДа
Фоновые звуки<extra.background-audio>ДаДа
Аббревиатуры, даты, числительные<say-as>ДаНет
Громкость, скорость, тон<paint> (атрибуты: pitch,
slope, speed, loudness)
ДаДа
Произнесение года полностью<extra.fulldate>ДаДа
Выделение слова интонацией* (перед словом)ДаДа
Ударения в словах' (после ударной гласной)ДаНет
Обработка букв е и ё' (после ё)ДаНет
Управление эмоциями<voice mode>ДаНет

Как использовать SSML

Если вы используете SSML-разметку, то в заголовке запроса на синтез Content-Type должно быть значение application/ssml.

Текст с разметкой размещается в теле запроса в теге speak, например:

<speak>
Привет!
<break time="200ms" />
Как прошел день?
<break strength="weak" />
<paint speed="2">Все хорошо?</paint>
</speak>

Перед отправкой запроса проверьте правильность оформления текста:

  • Все теги закрыты.
  • В запросе есть только один верхнеуровневый тег speak.
  • Все атрибуты — в двойных кавычках.
  • Символ & экранирован: &amp.
  • В тексте используются только теги, описанные в данном разделе.

Если при использовании тегов SSML вы получили ошибку, проверьте, что ваш запрос — это корректный XML.

Если запрос выглядит корректным, но все равно не работает — напишите нам на SaluteSpeech@sberbank.ru, указав свой ClientID.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.