Tutoriel TipTap
Vos rédacteurs dictent, l'éditeur écrit
Une extension TipTap et une route serveur : le texte arrive au curseur, sans les « euh », jamais reformulé. La clé secrète reste chez vous.
Ce qu'il vous faut≈ 10 min d'installation
- TipTap 3
- Un serveur capable de relayer une requête (Next.js, Express, Hono…)
- Une offre Vokyt avec des minutes de dictée
Étape 1 sur 4 · Copier la clé secrète
Pas à pas
01
Récupérez la clé secrète
sk_live_…
Tableau de bord → Sites et intégration → votre site → clé secrète. Mettez-la dans une variable d'environnement du serveur (VOKYT_SECRET_KEY). Elle ne doit jamais arriver dans le navigateur.
envVOKYT_SECRET_KEY=sk_live_…02
Installez l'extension
@vokyt/tiptap
Le paquet sera publié sur npm ; écrivez-nous à bonjour@vokyt.cc pour y accéder dès maintenant.
shpnpm add @vokyt/tiptap03
Ajoutez la route de relais
relayDictation
Le navigateur envoie l'audio à votre serveur, qui le relaie à Vokyt avec la clé secrète. Vérifiez ici que l'utilisateur est connecté.
tsimport { relayDictation } from "@vokyt/tiptap/server"; export async function POST(req: Request) { // Vérifiez ici que l'utilisateur est connecté return relayDictation(req, { secretKey: process.env.VOKYT_SECRET_KEY! }); }04
Ajoutez l'extension à l'éditeur
Dictation.configure
Ctrl/Cmd + Maj + D lance et arrête la dictée. Commandes : startDictation(), stopDictation(), toggleDictation(), cancelDictation().
tsimport { Dictation } from "@vokyt/tiptap"; new Editor({ extensions: [ StarterKit, Dictation.configure({ endpoint: "/api/vokyt/dictation", language: "fr", onStateChange: (state) => console.log(state), // idle | recording | transcribing }), ], });
Questions fréquentes
Combien de minutes de dictée ?
Celles de votre offre Vokyt (15 min avec Gratuit, 2 h avec Blogueur, 5 h avec Créateur, 15 h avec Pro par mois), partagées avec le tableau de bord, WordPress et les brouillons vocaux. 10 minutes au plus par prise.
L'audio est-il conservé ?
Non : il est transcrit puis oublié. Seuls la durée et le nombre de caractères sont gardés pour décompter les minutes.
Autres plateformes
Prêt à faire entendre votre voix ?
Créez votre compte, enregistrez un premier vocal et suivez les étapes : c'est gratuit pour commencer.