TutoriaisMac6 min de leitura
Ditado com sua chave da OpenAI no Mac: ajustes por app
Configure o ditado com a sua própria chave da OpenAI no Mac, ou com Ollama e LM Studio, e dê a cada app regras de limpeza próprias com o Router do Petal.
Publicado pela Optimal Apps, criadora do Petal.
Nesta página
Você pode configurar o ditado com a sua própria chave da OpenAI no Mac no Petal e pagar o provedor diretamente: a transcrição roda no Mac, e só o texto vai para a OpenAI para a limpeza. Abra Settings > Intelligence, escolha Cloud Model, escolha OpenAI, Anthropic, OpenRouter ou um Custom Server, como Ollama ou LM Studio, e cole a sua chave. Depois, abra Settings > Router e dê regras próprias a cada app: por exemplo, texto puro sem limpeza num editor de código e limpeza completa de e-mail no Mail. Este guia mostra os dois caminhos e explica o que sai do Mac em cada caso.
Os passos valem para o Petal 2.8.1 no macOS 26. A Optimal Apps publica o Petal, que é grátis e de código aberto. Os provedores na nuvem cobram as chamadas de API na sua própria conta.
Checklist rápido
| Verificação | Onde | Por quê |
|---|---|---|
| Um modelo de fala está baixado | Settings > Models | A fala é transcrita primeiro no Mac |
| O Cloud Model está configurado e verificado | Settings > Intelligence | Rotas que usam Cloud Model precisam de um provedor que funcione |
| A chave aparece como verificada | Settings > Intelligence > Cloud Provider | "Not Verified" significa que o provedor recusou a chave |
| Cada app tem a rota certa | Settings > Router | Uma rota substitui o padrão para um app ou site |
O prompt menciona <transcript> |
Instruções da rota | O Petal mostra um aviso e adiciona uma linha quando falta |
O que sai do Mac em cada opção
| Inteligência | O que roda e onde | O que sai do Mac |
|---|---|---|
| Off ou As Said | Modelo de fala no Mac | Nada |
| Petal W1 | Modelo de fala e Petal W1 no Mac | Nada |
| Apple Intelligence | Modelo de fala e o modelo da Apple no aparelho | Nada que o Petal envie |
| Cloud Model, Ollama ou LM Studio neste Mac | Modelo de fala e o seu servidor local | Nada, se o servidor roda no Mac |
| Cloud Model, OpenAI, Anthropic ou OpenRouter | Modelo de fala no Mac, limpeza no provedor | O texto da transcrição, as suas instruções e os dados das ferramentas que você ativar |
O seu áudio nunca vai para o provedor de limpeza. O Petal envia o texto. Ele só envia mais quando você ativa uma ferramenta:
- Screen envia uma captura de tela em cada ditado. Precisa do acesso a Gravação de Tela e não está disponível para servidores personalizados.
- Clipboard envia o que você copiou, quando você diz "isto".
- Selected Text envia o texto selecionado, para o modelo reescrever ou responder.
- Web Search permite que o modelo pesquise na web. O provedor cobra cada busca.
- Date and Time transforma "sexta que vem" numa data exata.
O Petal guarda as suas chaves no Acesso às Chaves do macOS e envia cada chave só ao provedor que você escolheu.
Passo 1: configure o ditado com a sua própria chave da OpenAI no Mac
- Clique no ícone do Petal na barra de menus e escolha Petal Settings….
- Abra Intelligence.
- Em Text Cleanup, selecione Cloud Model.
- Em Cloud Provider, escolha OpenAI, Anthropic, OpenRouter ou Custom Server.
OpenAI, Anthropic ou OpenRouter
- Clique em Get a key para abrir a página de chaves do provedor e crie uma chave.
- Cole a chave no campo da chave. Os textos de exemplo mostram o formato:
sk-proj-…para a OpenAI,sk-ant-…para a Anthropic,sk-or-…para o OpenRouter. - Clique em Verify.
- Abra o menu Model e escolha um modelo. O Petal sugere modelos rápidos e equilibrados para cada provedor. Você também pode digitar qualquer ID de modelo que o provedor aceite.
Ditado com Ollama ou LM Studio no Mac
- Inicie o seu servidor. No Ollama, baixe um modelo e deixe o Ollama aberto. No LM Studio, carregue um modelo e inicie o servidor local.
- No Petal, escolha Custom Server.
- Em Server URL, digite o endereço compatível com a OpenAI. Para o Ollama, é
http://localhost:11434/v1. Para o LM Studio, use o endereço que o LM Studio mostra, que costuma serhttp://localhost:1234/v1. - Deixe a chave vazia, a menos que o seu servidor peça uma.
- Clique em Verify para carregar os modelos do seu servidor e escolha um.
Um modelo local pequeno é rápido o bastante para a limpeza. Com um servidor no Mac, o ditado inteiro fica no Mac.
Teste o prompt
Comece por uma predefinição: Clean Up, Email, Notes, Professional, AI Prompt ou Assistant. Ou escreva o seu próprio prompt de sistema. Insira variáveis como {{name}}, {{app}} e {{window}}, que o Petal preenche no Mac. Depois, use Try It e clique em Run para ver o resultado num exemplo.
Passo 2: adicione uma rota para um editor de código
Num editor de código ou num terminal, muitas vezes você quer as suas palavras exatas, ou só uma limpeza leve.
- Abra Settings > Router.
- Em Routes, clique em Add App or Website.
- Escolha o editor em Open Apps, ou clique em Choose from Applications….
- Em Instructions, escolha um estilo:
- As Said cola as suas palavras sem limpeza.
- AI Prompt escreve um prompt claro para um agente de programação com IA.
- Custom permite escrever as suas próprias regras para esse app.
- Se você escolheu um estilo com limpeza, abra o menu Intelligence. Escolha Apple Intelligence para seguir o estilo no Mac, ou Cloud Model para usar o seu provedor. O Petal W1 também fica no Mac, mas usa um estilo próprio e não segue as instruções.
Se o ditado não chega ao editor de jeito nenhum, leia ditado não funciona no VS Code ou no Terminal.
Passo 3: adicione uma rota para o Mail
- Clique em Add App or Website de novo e escolha o Mail.
- Selecione o estilo Email. Ele adiciona uma saudação e uma despedida.
- Abra o menu Intelligence e escolha Cloud Model para usar o seu provedor, ou Apple Intelligence para ficar no aparelho.
- Clique em Run em Try It para conferir o resultado.
Passo 4: adicione uma rota para um site
Uma rota de site funciona em qualquer aba do navegador nesse site e nos subdomínios dele. Ela tem prioridade sobre a rota do app do navegador.
- Clique em Add App or Website e digite um domínio, como
github.com. - Escolha um estilo e uma inteligência.
Passo 5: defina o padrão para todos os outros apps
Clique em All Other Apps no Router. Ele usa a escolha de Settings > Intelligence, que aparece como Default (Petal W1) ou algo parecido. Para limpar só nos apps que têm rota própria, selecione As Said aqui.
Em Minimum Words, em Settings > Intelligence, ditados curtos como "OK" ou "beleza" pulam a limpeza e são colados do jeito que você falou.
Ajustes de ditado por app no Mac: um exemplo de configuração
| Rota | Estilo | Inteligência |
|---|---|---|
| Editor de código | As Said | nenhuma |
| Cloud Model | ||
| github.com | Clean Up | Apple Intelligence |
| All Other Apps | Clean Up | Default (Petal W1) |
Por que uma rota não faz o que você espera
- O modelo de limpeza não está pronto. O Router diz que o modelo "is not ready" e que o Petal cola as suas palavras do jeito que você falou até ele ficar pronto. Clique em Set Up.
- A chave aparece como Not Verified. A chave está errada, está sem crédito ou é de outro provedor. Crie uma chave nova e verifique.
- Uma aba do navegador ignora a rota do app. Uma rota de site para esse site tem prioridade sobre a rota do app.
- Aparece o aviso do prompt. O prompt precisa mencionar
<transcript>. Clique em Add. - Cada rota não pode ter o próprio provedor. Todas as rotas com Cloud Model usam o provedor de Settings > Intelligence. Use o Petal W1 ou o Apple Intelligence nas rotas que precisam ficar locais.
Para uma configuração totalmente offline, leia como converter voz em texto offline no Mac. Se você está comparando apps que usam a sua própria chave, leia alternativa de código aberto ao Superwhisper. Baixe o Petal para Mac para começar.
Perguntas
Posso usar a minha própria chave da OpenAI para ditar no Mac?
Sim. No Petal, abra Settings > Intelligence, selecione Cloud Model, escolha OpenAI, cole a sua chave e clique em Verify. O Petal continua transcrevendo a sua voz no Mac e envia só o texto à OpenAI para a limpeza.
Onde o Petal guarda a minha chave de API?
No Acesso às Chaves do macOS. O Petal não grava a chave num arquivo de ajustes e envia a chave só ao provedor que você escolheu.
Posso usar o Ollama ou o LM Studio para limpar o ditado?
Sim. Escolha Custom Server e digite a URL compatível com a OpenAI do seu servidor, como http://localhost:11434/v1 para o Ollama. Com um servidor no seu Mac, a etapa de limpeza fica no Mac.
Cada app pode usar um provedor na nuvem diferente?
Não. Cada rota pode escolher a própria inteligência (Apple Intelligence, Petal W1 ou Cloud Model) e as próprias instruções. Uma rota com Cloud Model usa o único provedor, modelo e ferramentas que você definiu em Settings > Intelligence.
O que acontece quando o provedor na nuvem está fora do ar?
A fala já foi transcrita no Mac. Se a limpeza falhar, use o Petal W1 nessa rota, ou o estilo As Said, que cola a transcrição sem limpeza.