DocumentatieWordPress & websites

Koerdische audio en Rastnivîs op je website

Geef elk artikel een luisterknop die het voorleest in natuurlijk Kurmancî, Soranî of Kirmanckî, en laat schrijvers hun Koerdische spelling controleren. Gebruik de WordPress-plug-in of één regel code op elke andere website.

WordPress-plug-in

  1. Download de plug-in en upload hem onder Plugins › Add New › Upload Plugin, activeer hem daarna.
  2. Log in op mazdek.ai, voeg tegoed toe en maak een API-sleutel aan onder Settings › API.
  3. Open in WordPress mazdek AI, plak de sleutel en druk op Connect. Je site wordt automatisch aan je account toegevoegd.
  4. Kies onder mazdek AI › Audio de taal, beluister de stemmen en selecteer er een, en bepaal welke berichten worden voorgelezen: alle, alleen bepaalde categorieën of alle behalve sommige.

In de blok-editor voegt het mazdek AI-paneel Rastnivîs (spelling, diakritische tekens, AI-grammatica) en een AI-schrijfassistent toe: verbeteren, inkorten, uitbreiden, samenvatting, koppen, metabeschrijving en vertaling.

Download de WordPress-plug-in

Elke andere website

Voeg je site toe onder Settings › API › Websites en plak dit in je paginasjabloon:

<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>

Je site-sleutel (mzpk_…) wordt daar getoond. Opties:

data-mazdek-siteJe openbare site-sleutel. Verplicht.
data-layout="compact"compact: één kleine knop in plaats van de volledige speler.
data-themelight (standaard), dark of auto om het systeem van de bezoeker te volgen.
data-accent="#0a7c4a"Uw merkkleur voor de knop en voortgang.
data-radiusCorners: afgerond (standaard), pill of square.
data-labelKnoptekst (standaard: "Luisteren" in de taal van de site).
data-wave · data-skip · data-speed · data-stickyInstellen op "false" om de waveform, 15 s overslaan, snelheidsregeling of de mini player getoond tijdens scrollen te verbergen.
data-player="auto"Plaats de speler boven het eerste <article> zonder placeholder.
data-credit="false"Verberg de kleine "mazdek AI"-link in de speler.
data-mazdek-playerWaar de luisterknop verschijnt. Eén per artikel.
data-url · data-title · data-targetOptioneel: het canonieke adres van het artikel, de titel en een CSS-selector voor de tekst.
data-mazdek-articleMarkeert exact de artikeltekst. Zonder dit leest de speler het eerste <article> of <main>.
data-mazdek-spellVoegt een Rastnivîs-knop toe onder een <textarea>, input of bewerkbaar gebied.

Welke pagina’s worden voorgelezen

Standaard kan elke pagina van je domeinen audio hebben. Voeg padregels toe (bijvoorbeeld /news/) om dit te beperken. In WordPress kies je in plaats daarvan berichttypes en categorieën, en elk bericht kan in de editor aan of uit worden gezet.

Beveiliging en privacy

De site-sleutel is opzettelijk openbaar, net als een mapsleutel: hij werkt alleen op de domeinen die je hebt geregistreerd. Voordat nieuwe audio wordt gemaakt, downloadt onze server je pagina en controleert of de tekst daar echt gepubliceerd staat, zodat niemand je account tekst kan laten voorlezen die niet op je site staat.

De speler plaatst geen cookies en slaat niets op over je bezoekers. Audio wordt via kortlevende privélinks aangeboden.

Prijzen

Audio wordt afgerekend van je tegoed tegen API-tarieven per teken. Elk artikel wordt één keer gegenereerd en daarna gratis aan elke luisteraar aangeboden; een maandelijks tekenlimiet per site beschermt je saldo. Spellingscontrole is gratis.

Voor ontwikkelaars

Om audio klaar te hebben zodra een artikel wordt gepubliceerd, verstuur je de tekst vanaf je server met je geheime API-sleutel:

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ê…" }'

De AI-schrijfassistent, grammaticacontrole en vertaling zijn gewone REST-eindpunten (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Roep ze aan vanuit je eigen back-end met je API-sleutel — zet de geheime sleutel nooit in een webpagina.

Talen: Kurmancî, Soranî en Kirmanckî (voorgelezen door de Kurmancî-stemmen). Beheer je websites