DokumentationWordPress & webbplatser

Kurdisk ljud och Rastnivîs på din webbplats

Ge varje artikel en lyssna-knapp som läser upp den på naturlig Kurmancî, Soranî eller Kirmanckî, och låt skribenter kontrollera sin kurdiska stavning. Använd WordPress-pluginet, eller en rad kod på vilken annan webbplats som helst.

WordPress-plugin

  1. Ladda ner pluginet och ladda upp det under Plugins › Lägg till ny › Ladda upp plugin, aktivera det sedan.
  2. Logga in på mazdek.ai, lägg till kredit och skapa en API-nyckel under Inställningar › API.
  3. I WordPress öppna mazdek AI, klistra in nyckeln och tryck på Anslut. Din webbplats läggs till i ditt konto automatiskt.
  4. Under mazdek AI › Ljud välj språk, lyssna på rösterna och välj en, och bestäm vilka inlägg som läses: alla, endast vissa kategorier, eller alla utom vissa.

I blockredigeraren lägger mazdek AI-panelen till Rastnivîs (stavning, diakritiska tecken, AI-grammatik) och en AI-skrivassistent: förbättra, förkorta, expandera, sammanfattning, rubriker, metabeskrivning och översättning.

Ladda ner WordPress-pluginet

Vilken annan webbplats som helst

Lägg till din webbplats under Inställningar › API › Webbplatser, klistra sedan in detta i din sidmall:

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

Din webbplatsnyckel (mzpk_…) visas där. Alternativ:

data-mazdek-siteDin publika webbplatsnyckel. Krävs.
data-layout="compact"compact: en liten knapp istället för den fullständiga spelaren.
data-themelight (standard), dark, eller auto för att följa besökarens system.
data-accent="#0a7c4a"Din varumärkesfärg för knappen och framstegen.
data-radiusHörn: rounded (standard), pill eller square.
data-labelKnapptext (standard: "Lyssna" på webbplatsens språk).
data-wave · data-skip · data-speed · data-stickySätt till "false" för att dölja vågformen, 15 s hopp, hastighetskontroll eller mini-spelaren som visas vid scrollning.
data-player="auto"Infoga spelaren ovanför det första <article> utan platshållare.
data-credit="false"Dölj den lilla "mazdek AI"-länken i spelaren.
data-mazdek-playerVar lyssna-knappen visas. En per artikel.
data-url · data-title · data-targetValfritt: artikelns kanoniska adress, dess titel och en CSS-väljare för dess text.
data-mazdek-articleMarkerar artikeltexten exakt. Utan den läser spelaren det första <article> eller <main>.
data-mazdek-spellLägger till en Rastnivîs-knapp under en <textarea>, input eller redigerbart område.

Vilka sidor som läses

Som standard kan varje sida på dina domäner ha ljud. Lägg till sökvägsregler (till exempel /news/) för att begränsa det. I WordPress väljer du istället inläggstyper och kategorier, och varje inlägg kan slås på eller av i redigeraren.

Säkerhet och integritet

Webbplatsnyckeln är offentlig av design, som en kartnyckel: den fungerar bara på de domäner du registrerat. Innan nytt ljud skapas laddar vår server ner din sida och kontrollerar att texten verkligen publicerats där, så ingen kan få ditt konto att läsa text som inte finns på din webbplats.

Spelaren sätter inga cookies och lagrar inget om dina besökare. Ljudfiler serveras via kortlivade privata länkar.

Prissättning

Ljud debiteras från din förbetalda kredit till API-priser, per tecken. Varje artikel genereras en gång och serveras sedan gratis till varje lyssnare; en månatlig teckengräns per webbplats skyddar din balans. Stavningskontroll är gratis.

För utvecklare

För att ha ljud redo i samma ögonblick som en artikel publiceras, skicka dess text från din server med din hemliga API-nyckel:

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

AI-skrivassistenten, grammatikkontroll och översättning är vanliga REST-slutpunkter (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Anropa dem från din egen backend med din API-nyckel — lägg aldrig den hemliga nyckeln i en webbsida.

Språk: Kurmancî, Soranî och Kirmanckî (läses av Kurmancî-rösterna). Hantera dina webbplatser