TutorielsMac7 min de lecture
Dictée vocale avec votre clé OpenAI sur Mac, app par app
Configurez la dictée vocale sur Mac avec votre propre clé OpenAI, ou avec Ollama et LM Studio, et donnez à chaque app ses règles de nettoyage avec Petal.
Publié par Optimal Apps, l’éditeur de Petal.
Sur cette page
Vous pouvez configurer la dictée vocale avec votre propre clé OpenAI sur Mac dans Petal, et payer directement le fournisseur. La transcription a lieu sur le Mac, et seul le texte part chez OpenAI pour le nettoyage. Ouvrez Settings > Intelligence, choisissez Cloud Model, sélectionnez OpenAI, Anthropic, OpenRouter ou un Custom Server comme Ollama ou LM Studio, et collez votre clé. Ouvrez ensuite Settings > Router et donnez à chaque app ses propres règles : par exemple, du texte brut sans nettoyage dans un éditeur de code, et un nettoyage complet pour les e-mails dans Mail. Ce guide présente les deux méthodes et explique ce qui quitte le Mac dans chaque cas.
Les étapes correspondent à Petal 2.8.1 sur macOS 26. Optimal Apps publie Petal, qui est gratuit et open source. Les fournisseurs cloud vous facturent les appels API sur votre propre compte.
La liste de contrôle
| Vérification | Où | Pourquoi |
|---|---|---|
| Un modèle de reconnaissance vocale est téléchargé | Settings > Models | La voix est d'abord transcrite sur le Mac |
| Cloud Model est configuré et vérifié | Settings > Intelligence | Les routes qui utilisent Cloud Model ont besoin d'un fournisseur qui fonctionne |
| La clé est marquée comme vérifiée | Settings > Intelligence > Cloud Provider | « Not Verified » signifie que le fournisseur a refusé la clé |
| Chaque app a la bonne route | Settings > Router | Une route remplace le réglage par défaut pour une app ou un site |
Le prompt contient <transcript> |
Instructions de la route | Petal affiche un avertissement et ajoute une ligne s'il manque |
Ce qui quitte le Mac selon votre choix
| Intelligence | Ce qui tourne et où | Ce qui quitte le Mac |
|---|---|---|
| Off ou As Said | Modèle de reconnaissance vocale sur le Mac | Rien |
| Petal W1 | Modèle de reconnaissance vocale et Petal W1 sur le Mac | Rien |
| Apple Intelligence | Modèle de reconnaissance vocale et modèle Apple sur l'appareil | Rien de ce que Petal envoie |
| Cloud Model, Ollama ou LM Studio sur ce Mac | Modèle de reconnaissance vocale et votre serveur local | Rien, si le serveur tourne sur le Mac |
| Cloud Model, OpenAI, Anthropic ou OpenRouter | Reconnaissance vocale sur le Mac, nettoyage chez le fournisseur | Le texte de la transcription, vos instructions et les données des outils que vous activez |
Votre audio ne part jamais chez le fournisseur de nettoyage. Petal envoie le texte. Il envoie plus seulement si vous activez un outil :
- Screen envoie une capture d'écran avec chaque dictée. Il demande l'accès à l'enregistrement de l'écran et n'est pas disponible avec les serveurs personnalisés.
- Clipboard envoie ce que vous avez copié, quand vous dites « ceci ».
- Selected Text envoie le texte sélectionné, pour que le modèle puisse le réécrire ou y répondre.
- Web Search permet au modèle de faire des recherches. Le fournisseur facture chaque recherche.
- Date and Time transforme « vendredi prochain » en date exacte.
Petal garde vos clés dans le trousseau macOS et les envoie seulement au fournisseur que vous avez choisi.
Étape 1 : configurer la dictée vocale avec votre propre clé OpenAI sur Mac
- Cliquez sur l'icône de Petal dans la barre des menus et choisissez Petal Settings….
- Ouvrez Intelligence.
- Sous Text Cleanup, sélectionnez Cloud Model.
- Sous Cloud Provider, choisissez OpenAI, Anthropic, OpenRouter ou Custom Server.
OpenAI, Anthropic ou OpenRouter
- Cliquez sur Get a key pour ouvrir la page des clés du fournisseur, et créez une clé.
- Collez la clé dans le champ prévu. Les exemples affichés montrent le format :
sk-proj-…pour OpenAI,sk-ant-…pour Anthropic,sk-or-…pour OpenRouter. - Cliquez sur Verify.
- Ouvrez le menu Model et choisissez un modèle. Petal suggère des modèles rapides et équilibrés pour chaque fournisseur. Vous pouvez aussi taper n'importe quel identifiant de modèle accepté par le fournisseur.
La dictée vocale avec Ollama ou LM Studio sur Mac
- Démarrez votre serveur. Pour Ollama, téléchargez un modèle et laissez Ollama ouvert. Pour LM Studio, chargez un modèle et démarrez son serveur local.
- Dans Petal, choisissez Custom Server.
- Dans Server URL, saisissez l'adresse compatible OpenAI. Pour Ollama, c'est
http://localhost:11434/v1. Pour LM Studio, utilisez l'adresse affichée par LM Studio, souventhttp://localhost:1234/v1. - Laissez le champ de la clé vide, sauf si votre serveur en demande une.
- Cliquez sur Verify pour charger les modèles de votre serveur, et choisissez-en un.
Un petit modèle local est assez rapide pour le nettoyage. Avec un serveur sur le Mac, toute la dictée reste sur le Mac.
Tester le prompt
Partez d'un préréglage : Clean Up, Email, Notes, Professional, AI Prompt ou Assistant. Ou écrivez votre propre prompt système. Insérez des variables comme {{name}}, {{app}} et {{window}}, que Petal remplit sur le Mac. Utilisez ensuite Try It et cliquez sur Run pour voir le résultat sur un exemple.
Étape 2 : ajouter une route pour un éditeur de code
Dans un éditeur de code ou un terminal, vous voulez souvent vos mots exacts, ou seulement un léger nettoyage.
- Ouvrez Settings > Router.
- Sous Routes, cliquez sur Add App or Website.
- Choisissez l'éditeur dans Open Apps, ou cliquez sur Choose from Applications….
- Sous Instructions, choisissez un style :
- As Said colle vos mots sans nettoyage.
- AI Prompt rédige un prompt clair pour un agent de code IA.
- Custom vous permet d'écrire vos propres règles pour cette app.
- Si vous avez choisi un style de nettoyage, ouvrez le menu Intelligence. Choisissez Apple Intelligence pour appliquer le style sur le Mac, ou Cloud Model pour utiliser votre fournisseur. Petal W1 reste aussi sur le Mac, mais il utilise son propre style et ne suit pas les instructions.
Si la dictée n'arrive pas du tout dans l'éditeur, lisez la dictée ne fonctionne pas dans VS Code ou Terminal.
Étape 3 : ajouter une route pour Mail
- Cliquez de nouveau sur Add App or Website et choisissez Mail.
- Sélectionnez le style Email. Il ajoute une formule d'appel et une formule de politesse.
- Ouvrez le menu Intelligence et choisissez Cloud Model pour utiliser votre fournisseur, ou Apple Intelligence pour rester sur l'appareil.
- Cliquez sur Run dans Try It pour vérifier le résultat.
Étape 4 : ajouter une route pour un site web
Une route de site web s'applique dans n'importe quel onglet de navigateur ouvert sur ce site et ses sous-domaines. Elle a la priorité sur la route de l'app du navigateur.
- Cliquez sur Add App or Website et tapez un domaine, comme
github.com. - Choisissez un style et une intelligence.
Étape 5 : définir le réglage par défaut pour toutes les autres apps
Cliquez sur All Other Apps dans le Router. Cette route utilise le choix fait dans Settings > Intelligence, affiché comme Default (Petal W1) ou similaire. Pour nettoyer seulement dans les apps qui ont leur propre route, sélectionnez As Said ici.
Avec Minimum Words, dans Settings > Intelligence, les dictées courtes comme « OK » ou « ça marche » ne passent pas par le nettoyage et sont collées telles que vous les avez dites.
Réglages de dictée par app sur Mac : un exemple de configuration
| Route | Style | Intelligence |
|---|---|---|
| Éditeur de code | As Said | aucune |
| Cloud Model | ||
| github.com | Clean Up | Apple Intelligence |
| All Other Apps | Clean Up | Default (Petal W1) |
Pourquoi une route ne fait pas ce que vous attendez
- Le modèle de nettoyage n'est pas prêt. Le Router indique que le modèle « is not ready » et que Petal colle vos mots tels que vous les avez dits en attendant. Cliquez sur Set Up.
- La clé affiche Not Verified. La clé est incorrecte, n'a plus de crédit ou appartient à un autre fournisseur. Créez une nouvelle clé et vérifiez-la.
- Un onglet de navigateur ignore la route de l'app. Une route de site web pour ce site a la priorité sur la route de l'app.
- L'avertissement sur le prompt apparaît. Le prompt doit contenir
<transcript>. Cliquez sur Add. - Chaque route ne peut pas avoir son propre fournisseur. Toutes les routes Cloud Model utilisent le fournisseur défini dans Settings > Intelligence. Utilisez Petal W1 ou Apple Intelligence pour les routes qui doivent rester en local.
Pour une configuration entièrement hors ligne, lisez convertir la voix en texte sur Mac hors ligne. Si vous comparez des apps qui acceptent vos propres clés, lisez les alternatives à Superwhisper. Téléchargez Petal pour Mac pour commencer.
Questions
Peut-on utiliser sa propre clé OpenAI pour la dictée sur Mac ?
Oui. Dans Petal, ouvrez Settings > Intelligence, sélectionnez Cloud Model, choisissez OpenAI, collez votre clé et cliquez sur Verify. Petal transcrit toujours votre voix sur le Mac et envoie seulement le texte à OpenAI pour le nettoyage.
Où Petal enregistre-t-il ma clé API ?
Dans le trousseau macOS. Petal n'écrit pas la clé dans un fichier de réglages, et il l'envoie seulement au fournisseur que vous avez choisi.
Peut-on utiliser Ollama ou LM Studio pour nettoyer la dictée ?
Oui. Choisissez Custom Server et saisissez l'URL compatible OpenAI de votre serveur, par exemple http://localhost:11434/v1 pour Ollama. Avec un serveur sur votre Mac, l'étape de nettoyage reste sur le Mac.
Chaque app peut-elle utiliser un fournisseur cloud différent ?
Non. Chaque route peut choisir sa propre intelligence (Apple Intelligence, Petal W1 ou Cloud Model) et ses propres instructions. Une route Cloud Model utilise le fournisseur, le modèle et les outils uniques définis dans Settings > Intelligence.
Que se passe-t-il quand le fournisseur cloud est en panne ?
La voix est déjà transcrite sur le Mac. Si le nettoyage échoue, utilisez Petal W1 pour cette route, ou le style As Said, qui colle la transcription sans nettoyage.