Code du widget de synthèse vocale : lire tout texte à voix haute

Un widget de synthèse vocale permet aux visiteurs de saisir ou de coller un texte et de l’entendre lu à voix haute avec une voix naturelle. Il est utile pour travailler la prononciation, créer rapidement des brouillons audio, apprendre une langue, et pour tous ceux qui préfèrent écouter plutôt que lire. Avec api14, vous l’ajoutez avec le même code d’intégration d’une ligne que tous les autres widgets.

Ce que reçoivent les visiteurs

• Une zone de texte et un bouton, avec vos propres libellés.
• Un audio généré qui se lit directement dans le widget.
• Un lien Télécharger, pour enregistrer l’audio et le réutiliser.

La voix et le modèle sont à votre choix. Les visiteurs ne voient jamais votre clé API, votre solde ni les messages d’erreur bruts du modèle.

Intégrez le widget de synthèse vocale

Créez un widget dans Widgets, choisissez le type Voix, puis enregistrez et copiez le code :

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Placez-le à l’endroit où le lecteur doit apparaître, ou affichez-le dans un élément avec data-target. Les widgets de synthèse vocale font 420px de haut par défaut ; modifiez cette valeur avec data-height. L’emplacement Bouton flottant ouvre plutôt le widget depuis un bouton dans un coin.

Choisissez un modèle et une voix

Le sélecteur de modèles liste les modèles de synthèse vocale avec leurs prix. Une fois un modèle choisi, le champ Voix affiche les voix que ce modèle propose. Si vous laissez la voix vide, le widget utilise la première voix du modèle, car certains fournisseurs exigent une voix explicite.

Écoutez plusieurs voix dans l’aperçu de l’éditeur avant de vous décider. Une voix qui convient à un site pour enfants n’est pas forcément adaptée à un cabinet d’avocats.

Choisissez la clé API

Chaque widget fonctionne avec l’une de vos clés API. Choisissez-en une dans l’éditeur, ou sélectionnez Créer une nouvelle clé API, la dernière option de la liste, pour créer une clé réservée à ce widget. La limite de dépense quotidienne, le débit de requêtes et les modèles autorisés de la clé s’appliquent alors à chaque requête du widget, et son utilisation est enregistrée sous cette clé.

Bonnes pratiques

• Utilisez le texte du champ pour expliquer ce que les visiteurs peuvent coller, par exemple « Collez jusqu’à un paragraphe de texte ».
• Définissez une limite de dépense quotidienne sur le widget. Le prix de la synthèse vocale dépend du modèle, et les textes longs coûtent plus cher que les textes courts.
• Dans Paramètres, Contrôles des widgets, limitez le nombre de requêtes qu’un visiteur peut envoyer par jour.
• Indiquez vos domaines dans Paramètres, Sites du widget pour que le widget ne fonctionne que sur vos pages.

Essayez un widget de synthèse vocale sans compte sur la page des widgets, et découvrez les modèles de synthèse vocale dans la documentation de synthèse vocale.