Retour au guide
🚀 Premiers pas

Mode Cloud & Bring Your Own Key

2026-05-24 · 4 min

Comment fonctionne le mode cloud

VoxWave embarque deux providers cloud câblés derrière un proxy gratuit : Groq pour la transcription (Whisper-large-v3-turbo) et OpenAI pour le nettoyage (GPT-4o-mini). Pas besoin de compte ni de clé API — ça marche directement.

  • Transcription en < 500ms via Groq (vs quelques secondes en local sur CPU)
  • Nettoyage intelligent avec GPT-4o-mini qui comprend le contexte et le ton
  • Fallback automatique vers Whisper local + regex si le cloud est injoignable
  • Le mode par défaut est Hybride — cloud d'abord, local comme filet de sécurité
💡

Le mode cloud est gratuit au lancement. Un plan Pro avec clés incluses pourrait arriver plus tard pour ceux qui veulent le confort, mais le défaut actuel est gratuit pour tout le monde.

Free forever — ce que ça veut dire

Pas de paywall, pas de tier, pas d'inscription. Le proxy cloud est hébergé par Farnel (solo founder) et la facture est prise en charge pour l'instant. Si l'usage explose et que la facture devient lourde, un plan Pro pourra arriver — mais les utilisateurs free actuels continueront à fonctionner comme aujourd'hui.

  • Cloud : gratuit via le proxy VoxWave (pas de clé, pas de compte)
  • Local : gratuit aussi, tourne à 100% sur ta machine (Whisper + regex/Ollama)
  • BYOK : branche ta propre clé Groq/OpenAI — contourne entièrement le proxy

Bring Your Own Key (BYOK)

Depuis la v0.2.2, tu peux coller ta propre clé API Groq ou OpenAI directement dans les Paramètres de VoxWave. Ça contourne entièrement le proxy VoxWave — les requêtes partent directement de ta machine vers le provider, facturées sur ton propre compte.

  • Clé Groq : free tier, pas de carte bancaire requise — super pour une transcription rapide avec ton propre quota
  • Clé OpenAI : nettoyage pay-as-you-go avec GPT-4o-mini facturé sur ton compte
  • Les clés sont stockées localement, chiffrées avec Fernet (~/.voxwave/apikeys.enc, permissions de fichier 0600)
  • Les clés ne touchent jamais les serveurs VoxWave — elles ne transitent qu'entre ta machine et le provider que tu as choisi
  • Le mode Hybride (par défaut) utilise toujours le proxy VoxWave et reste l'option recommandée pour la plupart des utilisateurs
  1. 1Ouvre Paramètres → Avancé
  2. 2Choisis « Ta propre clé API Groq » dans le dropdown de transcription, colle ta clé
  3. 3Choisis « Ta propre clé API OpenAI » dans le dropdown de nettoyage, colle ta clé
  4. 4Clique sur Sauvegarder — VoxWave recharge les providers immédiatement, pas besoin de redémarrer
💡

BYOK est pour les power users qui ont déjà des clés provider et préfèrent utiliser leur propre quota. Si tu ne sais pas quel mode choisir, laisse « Hybride » — ça marche tout seul.

🔒

Où récupérer une clé ? Groq : console.groq.com (gratuit, instantané). OpenAI : platform.openai.com (carte bancaire requise).