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_KEYcom a palavra Bearer faltando.Authorization: Bearer: YOUR_KEYcom um dois-pontos extra.Authorization: Bearer "YOUR_KEY"com aspas dentro do valor.Authorization: Bearer YOUR_KEYcom dois espaços.- Um cabeçalho chamado
X-API-Keyouapi-keyem vez deAuthorization. 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.pyfunciona, masAPI_KEY=abcem sua própria linha não alcança processos filhos. Useexport. - Sombreado por outro valor. Bibliotecas podem ler
OPENAI_API_KEYautomaticamente. 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ódigo | Significado usual | Onde procurar |
|---|---|---|
| 401 | Chave ausente ou inválida | Cabeçalho, chave, URL base |
| 429 | Limite de requisições ou sobrecarga temporária | Reduza a taxa e tente novamente; consulte os documentos para ver os limites |
| 400 | Corpo da requisição malformado | JSON, nome do modelo, parâmetros |
| 404 | Caminho errado | URL 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.
