Guías prácticasMac6 min de lectura
Dictar con tu propia clave de OpenAI en Mac: reglas por app
Dicta con tu propia clave de OpenAI en Mac, o con Ollama y LM Studio, y dale a cada app sus propias reglas de limpieza con el Router de Petal.
Publicado por Optimal Apps, el creador de Petal.
En esta página
Puedes configurar Petal para dictar con tu propia clave de OpenAI en Mac y pagarle directamente al proveedor: la transcripción se hace en la Mac y solo el texto va a OpenAI para limpiarlo. Abre Settings > Intelligence, elige Cloud Model, elige OpenAI, Anthropic, OpenRouter o un Custom Server como Ollama o LM Studio, y pega tu clave. Luego abre Settings > Router y dale a cada app sus propias reglas: por ejemplo, texto simple sin limpieza en un editor de código y una limpieza completa para correos en Mail. Esta guía muestra las dos opciones y explica qué sale de la Mac en cada caso.
Los pasos corresponden a Petal 2.8.1 en macOS 26. Optimal Apps publica Petal, que es gratis y de código abierto. Los proveedores en la nube te cobran las llamadas a la API en tu propia cuenta.
Lista rápida
| Revisión | Dónde | Por qué |
|---|---|---|
| Hay un modelo de voz descargado | Settings > Models | Primero la voz se transcribe en la Mac |
| Cloud Model está configurado y verificado | Settings > Intelligence | Las rutas que usan Cloud Model necesitan un proveedor que funcione |
| La clave aparece como verificada | Settings > Intelligence > Cloud Provider | "Not Verified" significa que el proveedor rechazó la clave |
| Cada app tiene la ruta correcta | Settings > Router | Una ruta reemplaza el valor predeterminado para una app o un sitio |
El prompt menciona <transcript> |
Instrucciones de la ruta | Si falta, Petal muestra un aviso y agrega una línea |
Qué sale de la Mac con cada opción
| Inteligencia | Qué se ejecuta y dónde | Qué sale de la Mac |
|---|---|---|
| Off o As Said | Modelo de voz en la Mac | Nada |
| Petal W1 | Modelo de voz y Petal W1 en la Mac | Nada |
| Apple Intelligence | Modelo de voz y el modelo de Apple en el dispositivo | Nada que envíe Petal |
| Cloud Model, con Ollama o LM Studio en esta Mac | Modelo de voz y tu servidor local | Nada, si el servidor se ejecuta en la Mac |
| Cloud Model, con OpenAI, Anthropic u OpenRouter | Modelo de voz en la Mac, limpieza en el proveedor | El texto de la transcripción, tus instrucciones y los datos de las herramientas que actives |
Tu audio nunca va al proveedor de limpieza. Petal envía el texto. Solo envía más cuando activas una herramienta:
- Screen envía una captura de pantalla con cada dictado. Necesita el permiso de Grabación de pantalla y no está disponible para servidores personalizados.
- Clipboard envía lo que copiaste, cuando dices "esto".
- Selected Text envía el texto seleccionado, para que el modelo lo reescriba o responda.
- Web Search permite que el modelo busque información. El proveedor cobra cada búsqueda.
- Date and Time convierte "el próximo viernes" en una fecha exacta.
Petal guarda tus claves en el llavero de macOS y solo las envía al proveedor que elegiste.
Paso 1: Configura el dictado con tu propia clave de OpenAI en Mac
- Haz clic en el ícono de Petal en la barra de menús y elige Petal Settings….
- Abre Intelligence.
- En Text Cleanup, elige Cloud Model.
- En Cloud Provider, elige OpenAI, Anthropic, OpenRouter o Custom Server.
OpenAI, Anthropic u OpenRouter
- Haz clic en Get a key para abrir la página de claves del proveedor y crea una clave.
- Pega la clave en el campo de la clave. El texto de ejemplo muestra el formato:
sk-proj-…para OpenAI,sk-ant-…para Anthropic,sk-or-…para OpenRouter. - Haz clic en Verify.
- Abre el menú Model y elige un modelo. Petal sugiere modelos rápidos y equilibrados para cada proveedor. También puedes escribir cualquier ID de modelo que acepte el proveedor.
Dictado con Ollama o LM Studio en Mac
- Inicia tu servidor. En Ollama, descarga un modelo y deja Ollama en ejecución. En LM Studio, carga un modelo e inicia su servidor local.
- En Petal, elige Custom Server.
- En Server URL, ingresa la dirección compatible con OpenAI. Para Ollama es
http://localhost:11434/v1. Para LM Studio, usa la dirección que muestra LM Studio, que suele serhttp://localhost:1234/v1. - Deja la clave vacía, salvo que tu servidor necesite una.
- Haz clic en Verify para cargar los modelos de tu servidor y elige uno.
Un modelo local pequeño es lo bastante rápido para la limpieza. Con un servidor en la Mac, todo el dictado se queda en la Mac.
Prueba el prompt
Empieza con un ajuste predefinido: Clean Up, Email, Notes, Professional, AI Prompt o Assistant. O escribe tu propio prompt de sistema. Agrega variables como {{name}}, {{app}} y {{window}}, que Petal completa en la Mac. Luego usa Try It y haz clic en Run para ver el resultado con un ejemplo.
Paso 2: Agrega una ruta para un editor de código
En un editor de código o una terminal, muchas veces quieres tus palabras exactas o solo una limpieza ligera.
- Abre Settings > Router.
- En Routes, haz clic en Add App or Website.
- Elige el editor en Open Apps, o haz clic en Choose from Applications….
- En Instructions, elige un estilo:
- As Said pega tus palabras sin limpieza.
- AI Prompt escribe un prompt claro para un agente de programación con IA.
- Custom te permite escribir tus propias reglas para esta app.
- Si elegiste un estilo con limpieza, abre el menú Intelligence. Elige Apple Intelligence para aplicar el estilo en la Mac, o Cloud Model para usar tu proveedor. Petal W1 también se queda en la Mac, pero usa su propio estilo y no sigue las instrucciones.
Si el dictado no llega al editor, lee el dictado no funciona en VS Code ni en Terminal.
Paso 3: Agrega una ruta para Mail
- Haz clic otra vez en Add App or Website y elige Mail.
- Elige el estilo Email. Agrega un saludo y una despedida.
- Abre el menú Intelligence y elige Cloud Model para usar tu proveedor, o Apple Intelligence para quedarte en el dispositivo.
- Haz clic en Run en Try It para revisar el resultado.
Paso 4: Agrega una ruta para un sitio web
Una ruta de sitio web funciona en cualquier pestaña del navegador con ese sitio y sus subdominios. Tiene prioridad sobre la ruta de la app del navegador.
- Haz clic en Add App or Website y escribe un dominio, como
github.com. - Elige un estilo y una inteligencia.
Paso 5: Configura el valor predeterminado para las demás apps
Haz clic en All Other Apps en el Router. Usa la opción de Settings > Intelligence, que aparece como Default (Petal W1) o algo parecido. Para limpiar solo en las apps que tienen su propia ruta, elige As Said aquí.
Con Minimum Words en Settings > Intelligence, los dictados cortos como "OK" o "me parece bien" omiten la limpieza y se pegan tal como los dijiste.
Ajustes de dictado por app en Mac: un ejemplo de configuración
| Ruta | Estilo | Inteligencia |
|---|---|---|
| Editor de código | As Said | ninguna |
| Cloud Model | ||
| github.com | Clean Up | Apple Intelligence |
| All Other Apps | Clean Up | Default (Petal W1) |
Por qué una ruta no hace lo que esperas
- El modelo de limpieza no está listo. El Router dice que el modelo "is not ready" y que, mientras tanto, Petal pega tus palabras tal como las dijiste. Haz clic en Set Up.
- La clave dice Not Verified. La clave es incorrecta, no tiene saldo o es de otro proveedor. Crea una clave nueva y verifícala.
- Una pestaña del navegador ignora la ruta de la app. Una ruta de sitio web para ese sitio tiene prioridad sobre la ruta de la app.
- Aparece el aviso del prompt. El prompt tiene que mencionar
<transcript>. Haz clic en Add. - Cada ruta no puede tener su propio proveedor. Todas las rutas con Cloud Model usan el proveedor de Settings > Intelligence. Usa Petal W1 o Apple Intelligence en las rutas que tienen que quedarse en la Mac.
Para una configuración totalmente sin conexión, lee pasar voz a texto en Mac sin conexión. Si comparas apps que usan tus propias claves, lee alternativas a Superwhisper. Descarga Petal para Mac para empezar.
Preguntas
¿Puedo usar mi propia clave de OpenAI para dictar en Mac?
Sí. En Petal, abre Settings > Intelligence, elige Cloud Model, elige OpenAI, pega tu clave y haz clic en Verify. Petal sigue transcribiendo tu voz en la Mac y solo envía el texto a OpenAI para limpiarlo.
¿Dónde guarda Petal mi clave de API?
En el llavero de macOS. Petal no escribe la clave en un archivo de configuración y solo la envía al proveedor que elegiste.
¿Puedo usar Ollama o LM Studio para limpiar el dictado?
Sí. Elige Custom Server e ingresa la URL compatible con OpenAI de tu servidor, como http://localhost:11434/v1 para Ollama. Con un servidor en tu Mac, el paso de limpieza se queda en la Mac.
¿Cada app puede usar un proveedor en la nube distinto?
No. Cada ruta puede elegir su propia inteligencia (Apple Intelligence, Petal W1 o Cloud Model) y sus propias instrucciones. Una ruta con Cloud Model usa el único proveedor, modelo y herramientas que configuraste en Settings > Intelligence.
¿Qué pasa si el proveedor en la nube tiene una caída?
La voz ya está transcrita en la Mac. Si la limpieza falla, usa Petal W1 en esa ruta, o el estilo As Said, que pega la transcripción sin limpieza.