Adicionar uma chave de provedor

O Perfica não possui nenhuma chave própria. Você adiciona chaves para os provedores que você já usa, e elas são armazenadas no seu computador. Ainda não tem uma chave? Começar de graça configura você com uma chave OpenRouter gratuita e uma chave Gemini gratuita: veja Primeira execução em modelos gratuitos.

Provedores suportados

Provedor	Precisa de chave	Notas
Anthropic	Sim
OpenAI	Sim
Google	Sim	Uma chave de API do Gemini. Possui um nível gratuito.
OpenRouter	Sim	Vários modelos sob uma única chave. Digite o nome de qualquer modelo.
NVIDIA	Sim	Digite o nome de qualquer modelo.
Ollama	Não	Executa no seu computador.
LM Studio	Não	Executa no seu computador.

Adicionando uma chave

1. Abra Configurações (a engrenagem, no canto superior direito) › APIs, pressione Adicionar chave e escolha o Provedor.
2. Marque uma favorita com a estrela se você tiver mais de uma chave para um provedor. Quando uma bubble não nomeia uma chave, o Perfica usa a favorita, depois a usada mais recentemente, e por fim a adicionada mais recentemente.

Em seguida, abra Configurações › Modelos e defina o modelo padrão. Ele é usado por todas as funções que não têm exceção, em cada quadro neste computador. Você pode alterar o modelo de qualquer bubble individual em seu inspetor.

Modelos que não custam nada

• Modelos locais. Ollama e LM Studio executam modelos no seu próprio computador. O Perfica os encontra em seus endereços habituais (127.0.0.1:11434 para o Ollama, 127.0.0.1:1234 para o LM Studio) e não precisa de chave para nenhum deles.
• Níveis gratuitos de provedores. Configurações › APIs › Modelos gratuitos › Começar de graça coloca os modelos gratuitos do OpenRouter e do Google em um único pool a partir de duas chaves gratuitas. Eles têm limites de taxa rigorosos: o Perfica conhece os limites deles, espaça suas chamadas para permanecer dentro deles e retoma um loop sozinho quando eles retornam. Veja Modelos, chaves e limites.

Onde as chaves ficam

• As chaves são criptografadas (AES-256-GCM) em um arquivo de chave neste computador.
• As páginas do aplicativo nunca mantêm uma chave. Uma bubble carrega apenas uma referência a ela.
• Uma chave salva para um provedor nunca é enviada para outro. Se uma bubble aponta para a chave do provedor errado, a passada para com um erro claro em vez de um “não autorizado” confuso.
• Com uma conta Cloud, você também pode manter chaves no cofre criptografado e movê-las entre computadores. O Cloud ainda não está à venda.

Próximo: Loops e bubbles.