O Olvio responde aos seus compradores com os modelos Claude da Anthropic, usando sua própria chave de API da Anthropic. A Anthropic cobra diretamente da sua conta da Anthropic as solicitações que o Olvio faz com a chave, separadamente do seu plano do Olvio.

A página Chave de API aparece no menu do app depois que você escolhe um plano. Se o guia de configuração ainda estiver visível no Painel (clique em Olvio no menu do app), a etapa Adicione sua chave de API da Anthropic leva à página pelo botão Adicionar chave. Quando uma chave é salva, a etapa é marcada como concluída e o botão muda para Gerenciar chave.

Se você definir uma data de expiração para a chave, substitua-a no Olvio antes dessa data. A Anthropic rejeita chaves expiradas, e o Olvio não consegue responder aos compradores até você conectar uma nova. A Anthropic envia um e-mail para quem criou a chave antes que ela expire, a menos que a chave tenha sido criada com validade inferior a 7 dias.

A menos que a Anthropic fature sua organização mensalmente, o uso da API do Claude é pago com créditos pré-pagos. Antes de salvar a chave no Olvio, verifique se sua organização tem créditos. Se não tiver, faça login no Claude Console com uma função Admin ou Billing, abra Settings → Billing e clique em Buy credits. Sem créditos, a Anthropic recusa a solicitação de teste do Olvio e a chave não pode ser salva. Para evitar que seu saldo acabe, clique em Edit na seção Auto-reload e ative a opção.

Antes de salvar, o Olvio remove espaços, quebras de linha, caracteres invisíveis e aspas curvas, e transforma travessões em hifens. Esses caracteres podem aparecer quando uma chave é copiada de um documento formatado. Em seguida, ele verifica a chave enviando à Anthropic uma solicitação de teste bem pequena com o modelo selecionado, que a Anthropic cobra como qualquer outra solicitação.

Quando a verificação é bem-sucedida, o Olvio criptografa e salva a chave. Você vê Configurações salvas, o campo fica vazio e o selo Status muda de Não configurada para Conectada. Conectada significa apenas que há uma chave salva. A página não verifica a chave com a Anthropic de novo, então o selo continua mostrando Conectada se a chave expirar depois, seu saldo de créditos acabar ou seu limite de gastos da Anthropic for atingido. Descartar apaga o que você digitou e volta o modelo ao valor salvo.

Quando uma verificação falha, nada é salvo e o Olvio mostra rapidamente uma mensagem de erro na parte inferior da página. Se ela sumir antes que você consiga ler, clique de novo em Salvar na barra de salvamento. Algumas mensagens que você pode ver:

Para as outras mensagens e soluções passo a passo, consulte Erro "Invalid Anthropic key" ao salvar.

O menu Modelo Claude oferece três modelos: Claude Haiku 4.5 — o mais rápido, menor custo (recomendado), Claude Sonnet 5 — equilíbrio entre qualidade e custo e Claude Opus 5 — melhor qualidade, custo mais alto. Como a página indica, o modelo selecionado é usado para cada conversa, sugestão e turno do advisor. A Anthropic cobra cada solicitação pela tarifa do modelo usado; consulte os preços da Anthropic.

Para trocar, selecione outro modelo e clique em Salvar. O Olvio primeiro verifica sua chave salva com o novo modelo, então você não precisa colar a chave de novo. Se ainda não houver chave salva, cole uma antes de salvar. Para escolher um modelo e ver para que ele é usado, consulte Escolha seu modelo Claude.

A Anthropic permite limitar seus gastos mensais com a API, o que protege você se um período movimentado trouxer mais conversas do que o esperado.

Quando seu uso atinge o limite, a Anthropic recusa novas solicitações até a data indicada, ou até você aumentar ou remover o limite. Durante esse período, o Olvio não consegue responder aos compradores, então deixe uma margem. O Olvio também para de responder se seu saldo de créditos acabar antes de o limite ser atingido. Você pode acompanhar seu uso na página Usage do Claude Console, e O que usa sua chave de API da Anthropic e o que não usa lista para que o Olvio usa a chave.

Substitua a chave quando criar uma nova, por exemplo depois de fazer a rotação dela ou de mudar para outra conta da Anthropic.

O Olvio verifica a nova chave com a Anthropic antes de salvar. Se a verificação for bem-sucedida, a nova chave substitui a antiga, e sua loja virtual passa a usá-la em cerca de um minuto. Se falhar, sua chave atual continua valendo. Quando a nova chave estiver funcionando, você pode desativar ou excluir a antiga no Claude Console.

Clique em Excluir chave na página Chave de API. O botão só aparece quando há uma chave salva, e não há etapa de confirmação: a chave é removida imediatamente, você vê Chave removida e o status volta para Não configurada. Sua escolha de modelo é mantida para quando você conectar uma chave novamente.

Sem chave, o Olvio não consegue responder aos compradores. Isso passa a valer na sua loja virtual em cerca de um minuto. O widget continua aparecendo nas suas páginas de produto, mas sem perguntas sugeridas, e toda mensagem recebe a resposta Lamentamos, ocorreu um erro. Por favor, tente novamente. (ou a tradução dela em uma loja virtual em outro idioma). Nos planos Growth e Scale, o Olvio Advisor também não consegue responder.

Excluir a chave no Olvio não a cancela na Anthropic. Se você não precisar mais dela, desative-a ou exclua-a no Claude Console.

O Olvio criptografa sua chave com AES-GCM (256 bits) antes de armazená-la, vinculada ao domínio da sua loja para que a chave criptografada não possa ser usada em outra loja. A chave nunca mais é exibida: o campo Chave de API mostra pontos no lugar dela. Quando você desinstala o Olvio, a chave é excluída junto com o restante dos dados da sua loja cerca de 48 horas depois. Para saber mais, consulte Como sua chave de API da Anthropic é criptografada.