DocumentationWordPress & sites web

Audio kurde et Rastnivîs sur votre site web

Ajoutez à chaque article un bouton d'écoute qui le lit en Kurmancî, Soranî ou Kirmanckî naturel, et permettez aux rédacteurs de vérifier leur orthographe kurde. Utilisez le plugin WordPress ou une ligne de code sur tout autre site web.

Plugin WordPress

  1. Téléchargez le plugin et téléversez-le sous Plugins › Add New › Upload Plugin, puis activez-le.
  2. Connectez-vous sur mazdek.ai, ajoutez du crédit et créez une clé API sous Settings › API.
  3. Dans WordPress, ouvrez mazdek AI, collez la clé et appuyez sur Connect. Votre site est ajouté automatiquement à votre compte.
  4. Sous mazdek AI › Audio, choisissez la langue, écoutez les voix et sélectionnez-en une, puis décidez quels articles sont lus : tous, seulement certaines catégories, ou tous sauf certaines.

Dans l'éditeur de blocs, le panneau mazdek AI ajoute Rastnivîs (orthographe, diacritiques, grammaire IA) et un assistant d'écriture IA : améliorer, raccourcir, développer, résumé, titres, méta-description et traduction.

Télécharger le plugin WordPress

Tout autre site web

Ajoutez votre site sous Settings › API › Websites, puis collez ceci dans votre modèle de page :

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

Votre clé de site (mzpk_…) y est affichée. Options :

data-mazdek-siteVotre clé de site publique. Obligatoire.
data-layout="compact"compact : un petit bouton à la place du lecteur complet.
data-themelight (par défaut), dark, ou auto pour suivre le système du visiteur.
data-accent="#0a7c4a"Votre couleur de marque pour le bouton et la progression.
data-radiusCoins : rounded (par défaut), pill ou square.
data-labelTexte du bouton (par défaut : "Écouter" dans la langue du site).
data-wave · data-skip · data-speed · data-stickyDéfinir sur "false" pour masquer la forme d'onde, le saut de 15 s, le contrôle de vitesse ou le mini lecteur affiché lors du défilement.
data-player="auto"Insérez le lecteur au-dessus du premier <article> sans espace réservé.
data-credit="false"Masquer le petit lien "mazdek AI" dans le lecteur.
data-mazdek-playerOù le bouton d'écoute apparaît. Un par article.
data-url · data-title · data-targetOptionnel : l'adresse canonique de l'article, son titre et un sélecteur CSS pour son texte.
data-mazdek-articleMarque exactement le texte de l'article. Sans cela, le lecteur lit le premier <article> ou <main>.
data-mazdek-spellAjoute un bouton Rastnivîs sous un <textarea>, input ou zone éditable.

Quelles pages sont lues

Par défaut, chaque page de vos domaines peut avoir de l'audio. Ajoutez des règles de chemin (par exemple /news/) pour le limiter. Dans WordPress, vous choisissez plutôt les types de contenu et catégories, et chaque article peut être activé ou désactivé dans l'éditeur.

Sécurité et confidentialité

La clé de site est publique par conception, comme une clé de carte : elle ne fonctionne que sur les domaines que vous avez enregistrés. Avant de créer un nouvel audio, notre serveur télécharge votre page et vérifie que le texte y est vraiment publié, afin que personne ne puisse faire lire par votre compte un texte qui n'est pas sur votre site.

Le lecteur ne définit pas de cookies et ne stocke rien sur vos visiteurs. Les fichiers audio sont servis via des liens privés à durée limitée.

Tarification

L'audio est facturé à partir de votre crédit prépayé aux tarifs API, par caractère. Chaque article est généré une fois puis servi gratuitement à chaque auditeur ; une limite mensuelle de caractères par site protège votre solde. La vérification orthographique est gratuite.

Pour les développeurs

Pour avoir l'audio prêt au moment de la publication d'un article, envoyez son texte depuis votre serveur avec votre clé API secrète :

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

L'assistant d'écriture IA, la vérification grammaticale et la traduction sont des points de terminaison REST standards (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Appelez-les depuis votre propre back-end avec votre clé API — ne placez jamais la clé secrète dans une page web.

Langues : Kurmancî, Soranî et Kirmanckî (lus par les voix Kurmancî). Gérer vos sites web