DocumentaciónWordPress y sitios web

Audio en kurdo y Rastnivîs en tu sitio web

Da a cada artículo un botón de escucha que lo lea en Kurmancî, Soranî o Kirmanckî natural, y permite a los escritores verificar su ortografía en kurdo. Usa el plugin de WordPress, o una línea de código en cualquier otro sitio web.

Plugin de WordPress

Descarga el plugin y súbelo en Plugins › Add New › Upload Plugin, luego actívalo.
Inicia sesión en mazdek.ai, agrega crédito y crea una clave API en Settings › API.
En WordPress abre mazdek AI, pega la clave y presiona Connect. Tu sitio se agrega a tu cuenta automáticamente.
En mazdek AI › Audio elige el idioma, escucha las voces y selecciona una, y decide qué publicaciones se leen: todas, solo algunas categorías, o todas excepto algunas.

En el editor de bloques el panel mazdek AI agrega Rastnivîs (ortografía, diacríticos, gramática con IA) y un asistente de escritura con IA: mejorar, acortar, expandir, resumen, titulares, meta descripción y traducción.

Descarga el plugin de WordPress

Cualquier otro sitio web

Agrega tu sitio en Settings › API › Websites, luego pega esto en tu plantilla de página:

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

Tu clave de sitio (mzpk_…) se muestra allí. Opciones:

data-mazdek-site	Tu clave de sitio pública. Obligatoria.
data-layout="compact"	compact: un botón pequeño en lugar del reproductor completo.
data-theme	light (predeterminado), dark, o auto para seguir el sistema del visitante.
data-accent="#0a7c4a"	Tu color de marca para el botón y el progreso.
data-radius	Esquinas: rounded (predeterminado), pill o square.
data-label	Texto del botón (predeterminado: "Escuchar" en el idioma del sitio).
data-wave · data-skip · data-speed · data-sticky	Establece en "false" para ocultar la forma de onda, el salto de 15 s, el control de velocidad o el mini reproductor mostrado al desplazarse.
data-player="auto"	Inserta el reproductor encima del primer <article> sin marcador de posición.
data-credit="false"	Oculta el pequeño enlace "mazdek AI" en el reproductor.
data-mazdek-player	Dónde aparece el botón de escucha. Uno por artículo.
data-url · data-title · data-target	Opcional: la dirección canónica del artículo, su título y un selector CSS para su texto.
data-mazdek-article	Marca exactamente el texto del artículo. Sin él, el reproductor lee el primer <article> o <main>.
data-mazdek-spell	Agrega un botón de Rastnivîs bajo un <textarea>, input o área editable.

Qué páginas se leen

De forma predeterminada, todas las páginas de tus dominios pueden tener audio. Agrega reglas de ruta (por ejemplo /news/) para limitarlo. En WordPress eliges tipos de publicación y categorías en su lugar, y cada publicación se puede activar o desactivar en el editor.

Seguridad y privacidad

La clave de sitio es pública por diseño, como una clave de mapa: solo funciona en los dominios que registraste. Antes de generar nuevo audio, nuestro servidor descarga tu página y verifica que el texto esté realmente publicado allí, para que nadie pueda hacer que tu cuenta lea texto que no está en tu sitio.

El reproductor no establece cookies ni almacena nada sobre tus visitantes. Los archivos de audio se sirven mediante enlaces privados de corta duración.

Precios

El audio se cobra de tu crédito prepago a las tarifas de la API, por carácter. Cada artículo se genera una vez y luego se sirve gratis a cada oyente; un límite mensual de caracteres por sitio protege tu saldo. La corrección ortográfica es gratis.

Para desarrolladores

Para tener el audio listo en el momento de publicar un artículo, envía su texto desde tu servidor con tu clave API secreta:

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

El asistente de escritura con IA, la corrección gramatical y la traducción son endpoints REST normales (/api/chat/v2, /api/spellcheck/grammar, /api/translate). Llámalos desde tu propio backend con tu clave API; nunca pongas la clave secreta en una página web.

Idiomas: Kurmancî, Soranî y Kirmanckî (leídos por las voces de Kurmancî). Administra tus sitios web