Курдское аудио и Rastnivîs на вашем сайте
Дайте каждой статье кнопку прослушивания, которая читает её на естественном Kurmancî, Soranî или Kirmanckî, и позвольте писателям проверять курдскую орфографию. Используйте плагин WordPress или одну строку кода на любом другом сайте.
Плагин WordPress
- Скачайте плагин и загрузите его в разделе Plugins › Add New › Upload Plugin, затем активируйте его.
- Войдите в mazdek.ai, пополните счёт и создайте API-ключ в разделе Settings › API.
- В WordPress откройте mazdek AI, вставьте ключ и нажмите Connect. Ваш сайт автоматически добавится в аккаунт.
- В mazdek AI › Audio выберите язык, прослушайте голоса и выберите один, а также решите, какие записи читать: все, только некоторые категории или все, кроме некоторых.
В блочном редакторе панель mazdek AI добавляет Rastnivîs (орфография, диакритические знаки, грамматика ИИ) и помощника по написанию ИИ: улучшить, сократить, расширить, summary, headlines, meta description и перевод.
Скачать плагин WordPressЛюбой другой сайт
Добавьте свой сайт в разделе Settings › API › Websites, затем вставьте это в шаблон страницы:
<script src="https://mazdek.ai/widget/v1.js"
data-mazdek-site="mzpk_YOUR_SITE_KEY" async></script>
<!-- where the listen button should appear -->
<div data-mazdek-player></div>
<article data-mazdek-article>
<h1>…</h1>
<p>…</p>
</article>
<!-- optional: Rastnivîs button under a text field -->
<textarea data-mazdek-spell></textarea>Ваш ключ сайта (mzpk_…) показан там. Опции:
| data-mazdek-site | Ваш публичный ключ сайта. Обязательно. |
| data-layout="compact" | compact: одна маленькая кнопка вместо полного плеера. |
| data-theme | light (по умолчанию), dark или auto, чтобы следовать системе посетителя. |
| data-accent="#0a7c4a" | Ваш фирменный цвет для кнопки и прогресса. |
| data-radius | Углы: rounded (default), pill or square. |
| data-label | Текст кнопки (по умолчанию: "Listen" на языке сайта). |
| data-wave · data-skip · data-speed · data-sticky | Установите "false", чтобы скрыть waveform, пропуск 15 с, управление скоростью или мини-плеер, показываемый при прокрутке. |
| data-player="auto" | Вставьте плеер над первым <article> без плейсхолдера. |
| data-credit="false" | Скрыть маленькую ссылку "mazdek AI" в плеере. |
| data-mazdek-player | Где появляется кнопка прослушивания. Одна на статью. |
| data-url · data-title · data-target | Необязательно: канонический адрес статьи, её заголовок и CSS-селектор для текста. |
| data-mazdek-article | Точно отмечает текст статьи. Без него плеер читает первый <article> или <main>. |
| data-mazdek-spell | Добавляет кнопку Rastnivîs под <textarea>, input или редактируемой областью. |
Какие страницы читаются
По умолчанию каждая страница ваших доменов может иметь аудио. Добавьте правила путей (например /news/), чтобы ограничить это. В WordPress вместо этого выбирайте типы записей и категории, и каждая запись может быть включена или выключена в редакторе.
Безопасность и конфиденциальность
Ключ сайта публичный по замыслу, как ключ карты: он работает только на доменах, которые вы зарегистрировали. Перед созданием нового аудио наш сервер загружает вашу страницу и проверяет, что текст действительно опубликован там, поэтому никто не может заставить ваш аккаунт читать текст, которого нет на вашем сайте.
Плеер не устанавливает куки и ничего не хранит о ваших посетителях. Аудиофайлы обслуживаются через краткосрочные приватные ссылки.
Цены
Аудио оплачивается из вашего предоплаченного кредита по тарифам API, за символ. Каждая статья генерируется один раз, а затем бесплатно обслуживается каждому слушателю; месячный лимит символов на сайт защищает ваш баланс. Проверка орфографии бесплатна.
Для разработчиков
Чтобы аудио было готово в момент публикации статьи, отправьте её текст с вашего сервера с вашим секретным API-ключом:
curl -X POST https://api.mazdek.ai/api/sites/SITE_ID/articles \
-H "Authorization: Bearer $MAZDEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "url": "https://example.com/news/123",
"title": "Sernav",
"text": "Nivîsa gotarê…" }'Помощник по написанию ИИ, проверка грамматики и перевод — это обычные REST-эндпоинты (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Вызывайте их из своего бэкенда с вашим API-ключом — никогда не помещайте секретный ключ на веб-страницу.
Языки: Kurmancî, Soranî и Kirmanckî (читается голосами Kurmancî). Управление вашими сайтами