DocumentazioneWordPress e siti web

Audio curdo e Rastnivîs sul tuo sito web

Offri a ogni articolo un pulsante di ascolto che lo legge in Kurmancî, Soranî o Kirmanckî naturale, e permetti agli scrittori di controllare l'ortografia curda. Usa il plugin WordPress, o una riga di codice su qualsiasi altro sito web.

Plugin WordPress

  1. Scarica il plugin e caricalo in Plugin › Aggiungi nuovo › Carica plugin, quindi attivalo.
  2. Accedi a mazdek.ai, aggiungi credito e crea una chiave API in Impostazioni › API.
  3. In WordPress apri mazdek AI, incolla la chiave e premi Connetti. Il tuo sito viene aggiunto automaticamente al tuo account.
  4. Sotto mazdek AI › Audio scegli la lingua, ascolta le voci e selezionane una, e decidi quali post vengono letti: tutti, solo alcune categorie, o tutti tranne alcuni.

Nel block editor il pannello mazdek AI aggiunge Rastnivîs (ortografia, diacritici, grammatica AI) e un assistente di scrittura AI: migliora, accorcia, espandi, riassunto, titoli, meta description e traduzione.

Scarica il plugin WordPress

Qualsiasi altro sito web

Aggiungi il tuo sito in Impostazioni › API › Siti web, quindi incolla questo nel template della tua pagina:

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

La tua chiave del sito (mzpk_…) è mostrata lì. Opzioni:

data-mazdek-siteLa tua chiave pubblica del sito. Obbligatoria.
data-layout="compact"compact: un piccolo pulsante invece del player completo.
data-themelight (predefinito), dark, o auto per seguire il sistema del visitatore.
data-accent="#0a7c4a"Il colore del tuo brand per il pulsante e la barra di avanzamento.
data-radiusAngoli: rounded (default), pill o square.
data-labelTesto del pulsante (predefinito: "Ascolta" nella lingua del sito).
data-wave · data-skip · data-speed · data-stickyImposta a "false" per nascondere la forma d'onda, il salto di 15 s, il controllo della velocità o il mini player mostrato durante lo scorrimento.
data-player="auto"Inserisci il player sopra il primo <article> senza segnaposto.
data-credit="false"Nascondi il piccolo link "mazdek AI" nel player.
data-mazdek-playerDove appare il pulsante di ascolto. Uno per articolo.
data-url · data-title · data-targetOpzionale: l'indirizzo canonico dell'articolo, il suo titolo e un selettore CSS per il suo testo.
data-mazdek-articleMarca esattamente il testo dell'articolo. Senza di esso il player legge il primo <article> o <main>.
data-mazdek-spellAggiunge un pulsante Rastnivîs sotto un <textarea>, input o area modificabile.

Quali pagine vengono lette

Per impostazione predefinita ogni pagina dei tuoi domini può avere audio. Aggiungi regole di percorso (ad esempio /news/) per limitarlo. In WordPress scegli invece i tipi di post e le categorie, e ogni post può essere attivato o disattivato nell'editor.

Sicurezza e privacy

La chiave del sito è pubblica per design, come una chiave per mappe: funziona solo sui domini che hai registrato. Prima di creare nuovo audio, il nostro server scarica la tua pagina e verifica che il testo sia davvero pubblicato lì, quindi nessuno può far leggere al tuo account testo che non è sul tuo sito.

Il player non imposta cookie e non memorizza nulla sui tuoi visitatori. I file audio vengono serviti tramite link privati di breve durata.

Prezzi

L'audio viene addebitato dal tuo credito prepagato alle tariffe API, per carattere. Ogni articolo viene generato una volta e poi servito a ogni ascoltatore gratuitamente; un limite mensile di caratteri per sito protegge il tuo saldo. Il controllo ortografico è gratuito.

Per sviluppatori

Per avere l'audio pronto nel momento in cui un articolo viene pubblicato, invia il suo testo dal tuo server con la tua chiave API segreta:

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'assistente di scrittura AI, il controllo grammaticale e la traduzione sono endpoint REST normali (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Chiamali dal tuo back end con la tua chiave API — non inserire mai la chiave segreta in una pagina web.

Lingue: Kurmancî, Soranî e Kirmanckî (lette dalle voci Kurmancî). Gestisci i tuoi siti web