Use sua própria chave de API
Configure o Self-Managed no NameQuick 3 para Mac e Windows com OpenAI, Anthropic, Gemini, OpenRouter, Mistral, o gateway de IA da sua universidade ou um servidor compatível com a OpenAI.
No Self-Managed, você traz sua própria chave de API (BYOK, “Bring Your Own Key”), e o NameQuick usa sua conta no provedor de IA.
Obtenha sua chave#
| Provedor | Onde criar a chave | Observe |
|---|---|---|
| OpenAI | Página de chaves de API | Uma assinatura do ChatGPT não inclui crédito de API; a cobrança da API é separada. |
| Anthropic | Claude Console, seguindo o guia de autenticação | Prefira uma chave restrita ao espaço de trabalho que você pretende usar no Claude Console, conforme a política da sua organização. |
| Gemini | Google AI Studio, seguindo o guia oficial | Cotas e termos de uso de dados dependem do nível de cobrança do projeto. Planos gratuitos podem ter termos diferentes: confira-os antes de processar documentos sensíveis. |
| OpenRouter | Conforme o guia oficial | Gerencie os créditos no OpenRouter. Use uma chave do OpenRouter, não uma chave direta de outro provedor. |
| Mistral | Console da Mistral | Alguns planos da Mistral permitem poucos pedidos por minuto em um modelo, ou nenhum. Se a renomeação pausar por limite de taxa, escolha outro modelo ou confira seus limites no console. |
| Custom | Documentação do servidor | Servidor compatível com a API de chat da OpenAI; veja abaixo. |
Conecte o provedor#
Abra ConfiguraçõesIA. Os passos são os mesmos no Mac e no Windows. Aqui, OpenAI é o exemplo; para Anthropic, Gemini, OpenRouter ou Mistral, escolha o provedor correspondente.
Escolha o provedor
Escolha OpenAI em Provedor. Se o provedor ainda não estiver conectado, a janela Conectar a OpenAI será aberta.
Cole a chave
Cole a chave em Cole sua chave de API da OpenAI. Espaços extras são removidos automaticamente.
Aguarde a verificação
A verificação pode começar automaticamente; caso contrário, clique em Conectar. Aguarde Verificando a chave… ou Validando a chave de API…. Somente uma chave verificada é salva.
Escolha o modelo
A conexão também define a OpenAI como provedor ativo. Depois, confira Modelo: um modelo recomendado vem pré-selecionado, mas você pode escolher outro. Alguns provedores oferecem Esforço de raciocínio, com níveis baixo, médio e alto. As mudanças de provedor e modelo são salvas automaticamente.
A confirmação é Conectado · chave salva nas Chaves do macOS.
A confirmação é Conectado · chave salva no Gestor de Credenciais do Windows.
Bom saber
A validação envia uma pequena solicitação real para verificar a chave e as condições de cobrança da conta. Isso pode gerar uma cobrança mínima no provedor.
Configure um servidor personalizado#
Para usar qualquer servidor compatível com a API de chat da OpenAI, selecione Custom em Provedor. Preencha URL base com o endereço fornecido pelo serviço e Nome do modelo com o identificador exato. Informe uma chave apenas se o servidor exigir. Usa o gateway de IA da sua universidade ou órgão público, como ELM, Chat AI (GWDG) ou Albert API? Veja Use o gateway de IA da sua universidade.
Atenção
Use https://. Sem HTTPS, o aplicativo avisa: A chave e o conteúdo dos arquivos vão sem criptografia para esse endereço.
Substitua ou remova uma chave#
As chaves ficam no macOS Keychain, no Mac, ou no Gerenciador de Credenciais do Windows (Windows Credential Manager), no Windows, não em um arquivo de configurações em texto simples. Elas continuam armazenadas quando você sai da conta NameQuick.
Em ConfiguraçõesIA, use Substituir para trocar a chave. Para excluí-la do NameQuick, clique em Remover e confirme em Remover chave. Remover uma chave no NameQuick não a revoga no provedor. Se houver suspeita de exposição, revogue-a também no painel do provedor.
Entenda os custos e a privacidade#
A licença do NameQuick e o uso do provedor são cobranças separadas. O custo depende do provedor, do modelo, do conteúdo dos arquivos e da sua conta. Antes de um lote grande, teste algumas cópias e confira as páginas de uso e cobrança do provedor.
Os testes com amostras em Testar esta predefinição são gratuitos no NameQuick, mas ainda usam seu provedor e podem gerar cobrança. Saiba mais sobre licença e créditos.
No Self-Managed com API em nuvem, os arquivos processados são enviados ao provedor escolhido para receber nomes; nada é enviado ao NameQuick para essa finalidade. O conteúdo necessário pode incluir o próprio arquivo, como imagens ou PDFs, não apenas trechos de texto.
OpenRouter e servidores personalizados têm políticas próprias de roteamento e uso de dados. Confira-as antes de enviar arquivos. O NameQuick não muda silenciosamente para Managed se o provedor falhar. Consulte Privacidade dos dados.
Resolva problemas comuns#
As mensagens abaixo usam OpenAI como exemplo.
“Chave de API inválida. Verifique e tente de novo.”
Confira se a chave pertence ao provedor selecionado e tente novamente.
Se aparecer A OpenAI recusou esta chave na última execução. Substitua-a para continuar., use Substituir para cadastrar outra chave.
“Sua conta OpenAI não tem crédito de API.”
A mensagem completa é Sua conta OpenAI não tem crédito de API. Adicione cobrança na OpenAI e tente de novo. Regularize a cobrança no provedor e repita a conexão. A chave não é salva nessa situação.
“Tempo esgotado” ou “Sem conexão com a internet”
Tempo esgotado — verifique sua internet ou Sem conexão com a internet: verifique a rede e tente novamente. Isso não comprova que a chave está errada.
Não foi possível validar agora. Tente de novo. Tente novamente mais tarde.
Lista de modelos indisponível
Não foi possível carregar a lista de modelos da OpenAI. Mostrando seu modelo atual e o conjunto recomendado. Você ainda pode escolher entre essas opções.
Armazenamento de chaves ilegível
Se o macOS Keychain ou o Gerenciador de Credenciais do Windows não puder ser lido, verifique o acesso ao armazenamento do sistema e consulte Solução de problemas. Não compartilhe a chave ao pedir ajuda.