Pular para o conteúdo
Petal

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

  1. Clique no ícone do Petal na barra de menus e escolha Petal Settings….
  2. Abra Intelligence.
  3. Em Text Cleanup, selecione Cloud Model.
  4. Em Cloud Provider, escolha OpenAI, Anthropic, OpenRouter ou Custom Server.

OpenAI, Anthropic ou OpenRouter

  1. Clique em Get a key para abrir a página de chaves do provedor e crie uma chave.
  2. 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.
  3. Clique em Verify.
  4. 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

  1. 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.
  2. No Petal, escolha Custom Server.
  3. 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 ser http://localhost:1234/v1.
  4. Deixe a chave vazia, a menos que o seu servidor peça uma.
  5. 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.

  1. Abra Settings > Router.
  2. Em Routes, clique em Add App or Website.
  3. Escolha o editor em Open Apps, ou clique em Choose from Applications….
  4. 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.
  5. 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

  1. Clique em Add App or Website de novo e escolha o Mail.
  2. Selecione o estilo Email. Ele adiciona uma saudação e uma despedida.
  3. Abra o menu Intelligence e escolha Cloud Model para usar o seu provedor, ou Apple Intelligence para ficar no aparelho.
  4. 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.

  1. Clique em Add App or Website e digite um domínio, como github.com.
  2. 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
Mail Email 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.