PT ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Obter chave de API

Erro 401 na API LLM: corrigindo falhas de autenticação

Um erro 401 na API LLM indica que o servidor não pôde autenticar sua requisição. Na grande maioria dos casos, a causa está no lado do cliente: um cabeçalho digitado incorretamente, uma chave com caractere estranho ou uma requisição enviada para o host errado. Este guia percorre as verificações na ordem que encontra o problema mais rapidamente.

Atualizado

Uma chave que não se encaixa em um cadeado brilhante, ilustrando uma falha de autenticação ao chamar uma API LLM

Pontos principais

  1. 401 é uma falha de autenticação, não um limite de requisições ou um erro de cobrança.
  2. O cabeçalho deve ser exatamente Authorization: Bearer SUA_CHAVE, com um espaço e sem aspas.
  3. Uma chave enviada para a URL base errada falha assim como uma chave errada.
  4. Teste com curl primeiro; se o curl funcionar, o bug está na configuração do seu app.

Execute este teste curl primeiro

Antes de alterar o código, remova seu app da equação. Este único comando envia a requisição mínima válida para a API:

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models não custa nada, então é uma maneira segura de testar uma chave. A flag -i imprime a linha de status e os cabeçalhos.

  • 200 e uma lista de modelos: a chave está correta. Seu app está enviando algo diferente, então vá para as seções sobre variáveis de ambiente e URL base.
  • 401: a chave ou o cabeçalho estão incorretos. Continue com a próxima seção.
  • Erro de conexão ou DNS: a URL base está errada, o que é um problema diferente do 401.

Cole a chave manualmente neste teste, não por meio de uma variável. Isso remove o ambiente da lista de suspeitos.

Causa 1: o cabeçalho não está exatamente certo

A API espera Authorization: Bearer <key>. Pequenas variações geram um erro 401 da API LLM:

  • Authorization: YOUR_KEY com a palavra Bearer faltando.
  • Authorization: Bearer: YOUR_KEY com um dois-pontos extra.
  • Authorization: Bearer "YOUR_KEY" com aspas dentro do valor.
  • Authorization: Bearer YOUR_KEY com dois espaços.
  • Um cabeçalho chamado X-API-Key ou api-key em vez de Authorization. Essas são convenções de outros serviços.

Se você usa um SDK OpenAI, não escreve o cabeçalho manualmente. O SDK o constrói a partir do argumento api_key. Se você ainda vê um 401, o valor passado para o SDK é o problema, não o formato do cabeçalho.

Causa 2: a chave em si está danificada

As chaves são sequências aleatórias longas, então erros de cópia são comuns e difíceis de identificar a olho nu.

  • Nova linha ou espaço final. Copiar de um terminal ou de um arquivo de texto frequentemente adiciona um. Muitas bibliotecas HTTP então enviam um cabeçalho inválido ou uma chave que não corresponde.
  • Chave truncada. O duplo clique seleciona apenas parte da sequência se a chave contiver caracteres que quebram a seleção de palavras. Use o botão copiar na página da chave de API em vez disso.
  • Aspas curvas. Colar por meio de um processador de texto ou app de chat pode trocar aspas retas por curvas.
  • Chave antiga ou rotacionada. Se você criou uma nova chave, a antiga pode não ser mais a que você está usando.

Para verificar caracteres invisíveis em Python, imprima o repr do valor:

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

Se a segunda linha imprimir False, você tem espaços em branco ao redor da chave. Chame .strip() ao lê-la.

Causa 3: a URL base errada

Este é o erro mais comum ao migrar um app existente para um novo provedor. Sua chave é válida apenas no host que a emitiu. A URL base para este site é:

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

Dois padrões de falha aparecem repetidamente:

  • Você definiu a nova chave, mas deixou a URL base antiga. A requisição vai para o provedor antigo, que rejeita uma chave que nunca viu e retorna 401. O texto do erro então menciona o provedor antigo, o que é uma pista útil.
  • Você definiu a nova URL base, mas deixou uma chave antiga no ambiente. A requisição chega até nós, e rejeitamos a chave do outro provedor.

Verifique também o caminho. A URL base já termina em /v1, então SDKs adicionam /chat/completions a ela. Se você construir a URL manualmente, o caminho completo é /v1/chat/completions, não /v1/v1/chat/completions.

Causa 4: variáveis de ambiente e arquivos de configuração

Se o curl funciona, mas seu app falha, algo está alimentando o app com uma chave diferente da que você acha.

  • Variável não exportada. Em um shell, API_KEY=abc python app.py funciona, mas API_KEY=abc em sua própria linha não alcança processos filhos. Use export.
  • Sombreado por outro valor. Bibliotecas podem ler OPENAI_API_KEY automaticamente. Se uma antiga estiver definida no perfil do seu shell, ela pode substituir o que você pretendia.
  • Aspas em um arquivo .env. Alguns carregadores mantêm as aspas como parte do valor. Se sua chave chegar envolta em caracteres de aspas, remova-as ou teste com a verificação repr acima.
  • Não reiniciado. Servidores e notebooks leem variáveis de ambiente na inicialização. Reinicie após editar.
  • Ambiente diferente em produção. Contêineres, CI e painéis de hospedagem têm seus próprios repositórios de variáveis. Imprima o comprimento da chave, nunca a própria chave, nos logs.

Uma verificação mínima em Python que comprova a configuração

Este script usa o SDK OpenAI e relata claramente se a autenticação falhar:

import os
from openai import OpenAI, AuthenticationError

client = OpenAI(
    base_url="https://api.unrestrictedaiapi.com/v1",
    api_key=os.environ["API_KEY"].strip(),
)

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Reply with the word ok."}],
        max_tokens=5,
    )
    print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
    print("401:", e.status_code, e.response.headers.get("X-Request-Id"))

Se isso imprimir um X-Request-Id, inclua-o ao escrever para suporte, pois isso permite que a equipe encontre sua requisição. A mesma verificação em outras linguagens está no guia rápido para cinco linguagens.

401 versus outros erros

Não perca tempo com autenticação se o erro for outra coisa. Um mapa curto:

CódigoSignificado usualOnde procurar
401Chave ausente ou inválidaCabeçalho, chave, URL base
429Limite de requisições ou sobrecarga temporáriaReduza a taxa e tente novamente; consulte os documentos para ver os limites
400Corpo da requisição malformadoJSON, nome do modelo, parâmetros
404Caminho erradoURL base e endpoint

Verifique também o nome do modelo. Use uncensored exatamente; um ID de modelo incorreto é um erro de requisição, não 401. Os detalhes da especificação, incluindo os endpoints e cabeçalhos que a API aceita, estão na página da especificação da API compatível com OpenAI.

Proxies, navegadores e último recurso

Duas configurações causam erros 401 que parecem misteriosos.

Proxies e gateways

Um proxy reverso, gateway de API ou wrapper serverless entre seu aplicativo e a API pode descartar ou reescrever o cabeçalho Authorization. Teste na mesma máquina com curl e compare. Alguns frameworks também encaminham o cabeçalho apenas para hosts da mesma origem, então um wrapper fetch personalizado pode perder silenciosamente o cabeçalho em uma chamada de origem cruzada.

Chaves em código front-end

Chamar a API diretamente do JavaScript do navegador expõe a chave para qualquer pessoa que abra as ferramentas de desenvolvedor, e os navegadores também podem bloquear a requisição por motivos de cross-origin que parecem erros de autenticação. Mantenha a chave em um servidor e faça com que seu front-end chame seu próprio endpoint, que por sua vez chama a API com a chave anexada. Se uma chave foi colada em código público ou em uma captura de tela, substitua-a.

Ainda preso

Se uma chave recém-copiada ainda retornar 401 no teste com curl, gere a chave novamente na página de chave de API, cole-a diretamente no comando e tente mais uma vez. Se isso falhar, envie ao suporte o horário da requisição, o endpoint e o cabeçalho de resposta X-Request-Id. Nunca envie a chave completa em uma mensagem; os primeiros e os últimos quatro caracteres são suficientes para identificá-la.

Perguntas e respostas

Um 401 significa que estou sem crédito?

Não. Um 401 é sobre autenticação: a chave está ausente, malformada ou desconhecida. Ficar sem crédito é uma condição separada.

Por que a mesma chave funciona no curl mas não no meu aplicativo?

Seu aplicativo provavelmente está lendo um valor diferente, como uma variável de ambiente antiga, uma entrada .env entre aspas ou uma chave com espaços em branco à direita. Imprima o comprimento e o repr da chave que seu código realmente usa.

Posso usar minha chave OpenAI com esta API?

Não. Cada chave funciona apenas no host que a emitiu. Use a chave da página de chaves de API junto com a URL base deste site.

Um 401 é cobrado?

Não. Requisições falhas ou recusadas não são cobradas.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API