Перейти к основному содержимому

Голосовой API (TTS)

Голос Dhamma.Gift — сервис синтеза речи: тот же, что читает в плеере сайта и в словаре. Обращаться к нему можно из браузера или с сервера, без ключа и без регистрации.

Условия использования
  • pratham, priyamvada, alan, kathleen, irina, puriso можно использовать свободно, в пределах лимитов ниже и лицензии каждого голоса.
  • dg, dgru, dgen (Cūḷa DG, Yojanāni DG) созданы по записям голосов реальных людей. Все права защищены. Использовать их можно только на сайте и в приложениях Dhamma.Gift. Любое другое использование через этот API, в том числе личное и некоммерческое, — только с предварительного письменного разрешения Dhamma.Gift.

Адрес: https://api.dhamma.gift · CORS открыт · лимит 60 запросов в минуту с одного IP.

Прочитать фразу​

POST /api/tts/pali с JSON:

ПолеЗначение
textтекст, до 2000 символов. Пали в IAST (Evaṁ me sutaṁ), перевод на английском или русском
voiceголос (ниже); по умолчанию pratham
rateскорость, 0.25–3; 1 — собственный темп голоса (сайт читает пали на 0.875)

Ответ — {"audioContent": "<MP3 в base64>"}, в том же виде, что у Google Text-to-Speech, так что плеер, написанный для Google, проигрывает его как есть. MP3, моно, 22 кГц, ~40 кбит/с; повторные запросы отдаются из кэша.

curl -s https://api.dhamma.gift/api/tts/pali -H 'content-type: application/json' \
-d '{"text":"Evaṁ me sutaṁ.","voice":"pratham","rate":0.875}' \
| python3 -c 'import json,sys,base64; open("evam.mp3","wb").write(base64.b64decode(json.load(sys.stdin)["audioContent"]))'
const r = await fetch('https://api.dhamma.gift/api/tts/pali', {
method: 'POST', headers: { 'content-type': 'application/json' },
body: JSON.stringify({ text: 'Evaṁ me sutaṁ.', voice: 'pratham', rate: 0.875 })
});
new Audio('data:audio/mp3;base64,' + (await r.json()).audioContent).play();

Голоса​

voiceЯзыкЧто это
prathamпали«Pratham»: нейроголос Piper + наши правила произношения пали (IAST → звуки, ударение, долгие гласные). По умолчанию
dgпали«Cūḷa DG»: голос, обученный на настоящем чтении пали. Бета
priyamvadaпали«Priyamvada»: женский голос Piper с теми же правилами
dgen, alan, kathleenанглийскийголоса Piper. dgen — «Yojanāni DG» (по умолчанию): обучен на чтении реального человека. Слова пали и сокращения (Ven., SN 56.11) читаются правильно
puriso, dgru, irinaрусскийголоса Piper. dgru — «Cūḷa DG» (по умолчанию); puriso — мужской голос M1 из Supertonic, перенесённый в Piper. Пали латиницей читается по-палийски, русские слова с правильными ударениями

GET /api/tts/dg-voices отдаёт список {"voices": [{"id", "lang", "label"}]} в порядке меню (первый голос языка — по умолчанию; Yojanāni DG там под внутренним id miles, он работает так же, как dgen); GET /api/tts/health показывает, что сервис работает и какая версия правил произношения в нём. GET /api/tts/offline/pali-ipa.json отдаёт правила, движок и модели голосов, которые DG скачивает, чтобы читать на устройстве без интернета.

Как читается пали: звучит каждая буква, знаки препинания дают паузы, …pe… читается как «peyyāla».

Весь текст одним MP3​

POST /api/tts/memo — строки читаются одна за другой с паузами любой длины между ними (у Google не больше 10 секунд); так сохраняет файл страница Memo.

ПолеЗначение
segmentsстроки, до 200 и до 20 000 символов всего
voice, rateкак выше
delayпауза между строками, секунд, до 3600
end_delayпауза в конце, секунд, до 3600
soundgong.mp3 или tick.mp3 в конце, или пусто

Ответ — сам MP3 (audio/mpeg): сама речь не дольше 30 минут, весь файл вместе с паузами не дольше 180. Такой запрос считается за десять в минутном лимите.

Лицензии​

  • Код сервиса и правила пали: github.com/dhammagift/pali-tts.
  • pratham: веса MIT (rhasspy/piper-voices), записи AI4Bharat IndicVoices (CC BY 4.0).
  • dg, dgru, dgen: все права защищены; только на сайте и в приложениях Dhamma.Gift, остальное — с предварительного письменного разрешения (см. «Условия использования» выше).
  • priyamvada, alan, kathleen, irina: rhasspy/piper-voices, у каждого своя лицензия.

Что ещё по этому адресу​

Тот же адрес отдаёт MCP-сервер (/mcp) и API сайта (/api/…) — те же тексты и та же база, что на dhamma.gift.