Use sua própria chave de API

Com a licença Self-Managed (traga sua própria chave, ou BYOK), o NameQuick usa a sua conta no provedor de IA em vez das renomeações gerenciadas. Você paga direto ao provedor pelo que usar, normalmente uma fração de centavo por renomeação, e paga o NameQuick uma vez só. Sua chave fica guardada com segurança no Keychain do macOS e nunca sai do seu Mac, a não ser para falar com o provedor que você escolheu.

Prefere pular as chaves de API? Use um modelo local no seu Mac: sem conta, sem chave, nada sai da sua máquina.

---

Adicionar uma chave ao NameQuick#

Os passos são os mesmos para todos os provedores de nuvem:

1. Abra NameQuick → Configurações → IA.
2. Escolha o provedor que você quer usar.
3. Cole sua chave de API no campo da chave. O NameQuick guarda a chave no Keychain do macOS.
4. Escolha um modelo (cada provedor já vem com uma opção padrão) e renomeie um arquivo de teste para confirmar que está tudo certo.

Depois de conectar um provedor, todas as renomeações continuam nele. O NameQuick nunca troca de provedor em silêncio.

---

Onde conseguir cada chave#

OpenAI#

1. Entre em platform.openai.com/api-keys.
2. Clique em Create new secret key, dê um nome como "NameQuick" e copie a chave. A OpenAI mostra a chave uma única vez.
3. Adicione um crédito pequeno em Billing se a sua conta ainda não tiver saldo. Alguns dólares cobrem milhares de renomeações.

Observação: uma conta de API da OpenAI é separada do ChatGPT Plus. Uma assinatura do ChatGPT não inclui crédito de API.

Anthropic (Claude)#

1. Entre em console.anthropic.com/settings/keys.
2. Clique em Create Key, copie a chave e adicione crédito em Plans & Billing se precisar.

Google Gemini#

1. Entre em aistudio.google.com com uma conta Google.
2. Clique em Create API key e copie a chave. O Gemini tem um plano gratuito generoso, o que faz dele um bom provedor para começar.

OpenRouter#

1. Entre em openrouter.ai/keys.
2. Clique em Create Key, copie a chave e adicione crédito ao seu saldo do OpenRouter.

Com o OpenRouter, uma única chave dá acesso a muitos modelos, o que ajuda se você quiser testar modelos diferentes sem abrir conta em cada provedor.

---

Quanto custa renomear com a sua própria chave#

Uma renomeação envia uma pequena quantidade de texto extraído (ou dados de imagem, no caso de fotos e digitalizações) para o provedor e recebe de volta um nome de arquivo curto. Os preços exatos mudam, mas com os modelos populares de hoje uma renomeação típica de documento custa bem menos de um centavo, e mesmo lotes grandes de imagens continuam baratos. Confira o painel do seu provedor depois do primeiro lote: os valores costumam ser bem menores do que se imagina.

---

Notas de privacidade#

• As chaves ficam no Keychain do macOS, não nos arquivos de configuração do NameQuick.
• Só o texto extraído (ou a imagem, para análise visual) é enviado ao provedor que você escolheu. Os arquivos em si nunca são enviados para os servidores do NameQuick.
• Para processamento sem nenhuma nuvem, veja modelos locais.
• O detalhamento completo do que sai do seu Mac em cada modo: Privacidade e seus dados.

---

Problemas comuns#

"Add your API key in Settings → AI": o provedor selecionado ainda não tem chave, ou a chave foi removida. Cole uma chave válida e tente de novo.

As renomeações falham logo depois de adicionar a chave: quase sempre a conta do provedor está sem crédito. Confira a página de cobrança do provedor; chaves só funcionam quando a conta pode ser cobrada.

Erros de limite de requisições em lotes grandes: contas novas costumam ter limites baixos, que aumentam automaticamente depois de alguns dias de uso. Processe um lote menor ou espere um pouco e tente de novo.

Para todo o resto, veja Solução de problemas.