Quando você clica em Salvar na barra de salvamento da página Chave de API, o Olvio primeiro limpa a chave que você colou e verifica se ela tem o formato de uma chave da Anthropic. Em seguida, envia à Anthropic uma solicitação de teste bem pequena com o modelo selecionado em Modelo Claude. Se alguma dessas verificações falhar, nada é salvo e o Olvio mostra uma mensagem de erro. A mensagem aparece só por alguns instantes na parte inferior da página. Se ela sumir antes que você consiga ler, clique de novo em Salvar na barra de salvamento. Este artigo explica as mensagens que você pode ver e como resolvê-las. Para conectar uma chave pela primeira vez, consulte Conecte sua chave de API da Anthropic (Claude).

Essas mensagens de erro são sempre exibidas em inglês, seja qual for o idioma do seu painel administrativo do Olvio.

A Anthropic recusou a própria chave. A chave pode ter sido digitada errado, estar incompleta, desativada, excluída ou expirada, ou pode não ter permissão para usar a API do Claude no workspace dela. Uma chave também para de funcionar quando a pessoa ou a conta de serviço à qual está vinculada perde o acesso à sua organização ou ao seu workspace da Anthropic.

Se a Anthropic também recusar uma chave recém-criada, verifique o acesso da sua organização e as configurações do workspace no Claude Console. Se várias pessoas gerenciam sua conta da Anthropic, defina Linked account como uma conta de serviço ao criar a chave, para que ela não pare de funcionar quando uma pessoa sair. As contas de serviço são criadas por um administrador da organização no Claude Console.

O Olvio mostra essa mensagem antes de contatar a Anthropic, quando o que você colou não tem o formato de uma chave da Anthropic. Uma chave da Anthropic começa com sk-ant- e contém apenas letras, números, hifens e sublinhados.

O Olvio já remove do que você cola os espaços (incluindo espaços de largura zero e espaços não separáveis), as quebras de linha e as aspas tipográficas, e transforma travessões em hifens. Se mesmo assim você vir essa mensagem, as causas mais prováveis são:

Cole a chave de novo a partir de onde você a guardou quando a criou, sem copiá-la por um documento formatado. O Claude Console mostra uma chave apenas uma vez; por isso, se você não a tiver mais, crie uma nova chave em Settings → API keys.

Se, em vez disso, você vir "Please enter an API key.", nada utilizável foi colado (por exemplo, apenas espaços) e ainda não há nenhuma chave salva. Copie a chave de novo e cole-a no campo Chave de API.

A Anthropic recusou a solicitação de teste, e o modelo nem sempre é a causa. Quando a Anthropic informa um motivo, a mensagem o inclui logo depois dos dois-pontos, e é esse motivo que diz o que você precisa corrigir. A sugestão final de tentar outro modelo Claude é adicionada pelo Olvio e só ajuda quando o motivo tem a ver com o modelo:

Se a mensagem não informar nenhum motivo ("Anthropic rejected this model for your account. Your tier may not allow this model…"), escolha Claude Haiku 4.5 — o mais rápido, menor custo (recomendado) em Modelo Claude e clique uma vez em Salvar na barra de salvamento. Se, em vez disso, a barra de salvamento se fechar, o Claude Haiku 4.5 já é seu modelo salvo, mas a causa ainda pode afetar sua chave salva: verifique seus limites de gastos e seu saldo de créditos no Claude Console, ou cole sua chave no campo Chave de API e clique em Salvar para testá-la com o Haiku. Se o salvamento continuar falhando, verifique seus limites de gastos e seu saldo de créditos no Claude Console e entre em contato conosco. Consulte Contate-nos e horário de suporte.

A mensagem diz, por exemplo, "Anthropic returned HTTP 402. Please retry; if it persists, contact Olvio support with this code." A Anthropic respondeu com um erro que não tem uma mensagem própria no Olvio, e o código indica que tipo de problema é. 402 significa que a Anthropic encontrou um problema nas suas informações de cobrança ou de pagamento: verifique seus dados de pagamento no Claude Console e salve de novo.

Se a mensagem continuar aparecendo, entre em contato conosco e informe o código. Consulte Contate-nos e horário de suporte.

A menos que sua organização receba fatura mensal da Anthropic, o uso da API do Claude é pago com créditos pré-pagos. Quando seu saldo de créditos acaba, a Anthropic recusa todas as solicitações, seja qual for o modelo, até você adicionar mais. A solicitação de teste do Olvio também é recusada, então o salvamento falha com uma das mensagens deste artigo. Se o salvamento continuar falhando, verifique seu saldo:

Estas mensagens não significam que sua chave está errada:

Se já houver uma chave salva e você escolher outro modelo sem colar uma chave, o Olvio testa sua chave salva com o novo modelo antes de salvar. As mensagens da Anthropic acima também podem aparecer nesse caso. Mais uma mensagem pode aparecer somente aqui:

Para escolher um modelo e ver para que ele é usado, consulte Escolha seu modelo Claude.

O Olvio nunca armazena uma chave que não passou na verificação. Se já havia uma chave salva, ela continua em uso, o selo Status continua mostrando Conectada e seu modelo salvo não muda. A página mantém o que você digitou para que você possa corrigir, e o menu Modelo Claude continua mostrando o modelo que você escolheu, mesmo que ele não tenha sido salvo. Para apagar o que você digitou e voltar ao seu modelo salvo, clique em Descartar na barra de salvamento. Quando o salvamento dá certo, você vê Configurações salvas.

O Olvio só verifica sua chave quando você a salva. O selo Conectada significa que há uma chave salva, não que a Anthropic ainda a aceite. Os compradores veem Lamentamos, ocorreu um erro. Por favor, tente novamente. no chat (ou a tradução dessa mensagem em uma loja virtual em outro idioma), por exemplo nestes casos:

Para corrigir, resolva o problema no Claude Console, ou crie uma nova chave, cole-a na página Chave de API e clique em Salvar na barra de salvamento. O chat responde "Lamentamos, ocorreu um erro. Por favor, tente novamente." lista outras causas dessa mensagem no chat.