mazdek AI
DokumentationWordPress & Websites

Kurdisches Audio und Rastnivîs auf Ihrer Website

Geben Sie jedem Artikel einen Hör-Button, der ihn in natürlichem Kurmancî, Soranî oder Kirmanckî vorliest, und lassen Sie Autoren ihre kurdische Rechtschreibung prüfen. Verwenden Sie das WordPress-Plugin oder eine Zeile Code auf jeder anderen Website.

WordPress-Plugin

  1. Laden Sie das Plugin herunter und laden Sie es unter Plugins › Add New › Upload Plugin hoch, dann aktivieren Sie es.
  2. Melden Sie sich bei mazdek.ai an, fügen Sie Guthaben hinzu und erstellen Sie einen API-Schlüssel unter Einstellungen › API.
  3. Öffnen Sie in WordPress mazdek AI, fügen Sie den Schlüssel ein und drücken Sie Verbinden. Ihre Website wird automatisch zu Ihrem Konto hinzugefügt.
  4. Unter mazdek AI › Audio wählen Sie die Sprache, hören Sie sich die Stimmen an und wählen Sie eine aus, und entscheiden Sie, welche Beiträge vorgelesen werden: alle, nur einige Kategorien oder alle außer einigen.

Im Block-Editor fügt das mazdek AI-Panel Rastnivîs (Rechtschreibung, Diakritika, KI-Grammatik) und einen KI-Schreibassistenten hinzu: verbessern, kürzen, erweitern, Zusammenfassung, Überschriften, Meta-Beschreibung und Übersetzung.

Laden Sie das WordPress-Plugin herunter

Jede andere Website

Fügen Sie Ihre Website unter Einstellungen › API › Websites hinzu, dann fügen Sie dies in Ihre Seitenvorlage ein:

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

Ihr Website-Schlüssel (mzpk_…) wird dort angezeigt. Optionen:

data-mazdek-siteIhr öffentlicher Website-Schlüssel. Erforderlich.
data-layout="compact"compact: ein kleiner Button anstelle des vollständigen Players.
data-themelight (Standard), dark oder auto, um dem System des Besuchers zu folgen.
data-accent="#0a7c4a"Ihre Markenfarbe für den Button und den Fortschritt.
data-radiusEcken: rounded (Standard), pill oder square.
data-labelButton-Text (Standard: "Anhören" in der Sprache der Website).
data-wave · data-skip · data-speed · data-stickyAuf "false" setzen, um die Wellenform, 15 s Überspringen, Geschwindigkeitssteuerung oder den Mini-Player beim Scrollen auszublenden.
data-player="auto"Fügen Sie den Player über dem ersten <article> ohne Platzhalter ein.
data-credit="false"Verbergen Sie den kleinen "mazdek AI"-Link im Player.
data-mazdek-playerWo der Hör-Button erscheint. Einer pro Artikel.
data-url · data-title · data-targetOptional: die kanonische Adresse des Artikels, sein Titel und ein CSS-Selektor für seinen Text.
data-mazdek-articleMarkiert den Artikeltext genau. Ohne ihn liest der Player den ersten <article> oder <main>.
data-mazdek-spellFügt einen Rastnivîs-Button unter einem <textarea>, input oder editierbaren Bereich hinzu.

Welche Seiten vorgelesen werden

Standardmäßig kann jede Seite Ihrer Domains Audio haben. Fügen Sie Pfadregeln (zum Beispiel /news/) hinzu, um es einzuschränken. In WordPress wählen Sie stattdessen Beitragstypen und Kategorien, und jeder Beitrag kann im Editor ein- oder ausgeschaltet werden.

Sicherheit und Datenschutz

Der Website-Schlüssel ist absichtlich öffentlich, wie ein Kartenschlüssel: Er funktioniert nur auf den Domains, die Sie registriert haben. Bevor neues Audio erstellt wird, lädt unser Server Ihre Seite herunter und prüft, dass der Text dort wirklich veröffentlicht ist, damit niemand Ihr Konto veranlassen kann, Text vorzulesen, der nicht auf Ihrer Website ist.

Der Player setzt keine Cookies und speichert nichts über Ihre Besucher. Audio-Dateien werden über kurzlebige private Links bereitgestellt.

Preise

Audio wird von Ihrem Guthaben zu API-Tarifen pro Zeichen abgerechnet. Jeder Artikel wird einmal generiert und dann jedem Hörer kostenlos bereitgestellt; ein monatliches Zeichenlimit pro Website schützt Ihr Guthaben. Die Rechtschreibprüfung ist kostenlos.

Für Entwickler

Damit Audio bereit ist, sobald ein Artikel veröffentlicht wird, senden Sie seinen Text von Ihrem Server mit Ihrem geheimen API-Schlüssel:

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

Der KI-Schreibassistent, die Grammatikprüfung und die Übersetzung sind reguläre REST-Endpunkte (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Rufen Sie sie von Ihrem eigenen Backend mit Ihrem API-Schlüssel auf — legen Sie den geheimen Schlüssel niemals in eine Webseite.

Sprachen: Kurmancî, Soranî und Kirmanckî (von den Kurmancî-Stimmen gelesen). Verwalten Sie Ihre Websites