Voer deze curl-test eerst uit
Haal je app eruit voordat je code aanpast. Dit ene commando stuurt het minimaal geldige verzoek naar de API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models kost niets, dus het is een veilige manier om een sleutel te testen. De vlag -i geeft de statusregel en headers weer.
- 200 en een modellijst: de sleutel is in orde. Je app stuurt iets anders, dus ga naar de secties over omgevingsvariabelen en base URL.
- 401: de sleutel of de header is verkeerd. Ga verder met de volgende sectie.
- Verbindings- of DNS-fout: de base URL is verkeerd, wat een ander probleem is dan 401.
Plak de sleutel handmatig in deze test, niet via een variabele. Dat haalt de omgeving uit de lijst van verdachten.
Oorzaak 1: de header is niet helemaal goed
De API verwacht Authorization: Bearer <key>. Kleine afwijkingen veroorzaken allemaal een LLM API-fout 401:
Authorization: YOUR_KEYmet het woord Bearer dat ontbreekt.Authorization: Bearer: YOUR_KEYmet een extra dubbele punt.Authorization: Bearer "YOUR_KEY"met aanhalingstekens binnen de waarde.Authorization: Bearer YOUR_KEYmet twee spaties.- Een header genaamd
X-API-Keyofapi-keyin plaats vanAuthorization. Dat zijn conventies van andere diensten.
Als je een OpenAI SDK gebruikt, schrijf je de header niet zelf. De SDK bouwt deze op basis van het argument api_key. Als je toch een 401 ziet, is de waarde die aan de SDK wordt doorgegeven het probleem, niet de headerindeling.
Oorzaak 2: de sleutel zelf is beschadigd
Sleutels zijn lange willekeurige strings, dus fouten bij het kopiëren komen veel voor en zijn met het oog moeilijk te zien.
- Een nieuwe regel of spatie aan het eind. Kopiëren vanuit een terminal of tekstbestand voegt er vaak een toe. Veel HTTP-bibliotheken sturen dan een ongeldige header of een sleutel die niet overeenkomt.
- Ingekorte sleutel. Dubbelklikken selecteert slechts een deel van de tekenreeks als de sleutel tekens bevat die woordselectie verstoren. Gebruik in plaats daarvan de knop Kopiëren op de API-sleutel-pagina.
- Slimme aanhalingstekens. Plakken via een tekstverwerker of chatapp kan rechte aanhalingstekens vervangen door gekrulde.
- Oude of gedraaide sleutel. Als je een nieuwe sleutel hebt gemaakt, is de oude mogelijk niet langer de sleutel die je gebruikt.
Om te controleren op onzichtbare tekens in Python, print je de repr van de waarde:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Als de tweede regel False print, heb je spaties rond de sleutel. Roep .strip() aan wanneer je deze leest.
Oorzaak 3: de verkeerde base URL
Dit is de meest voorkomende fout bij het overschakelen van een bestaande app naar een nieuwe provider. Je sleutel is alleen geldig op de host die hem heeft uitgegeven. De base URL voor deze site is:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Twee foutpatronen komen steeds weer terug:
- Je stelt de nieuwe sleutel in, maar laat de oude base URL staan. Het verzoek gaat naar de oude provider, die een sleutel die hij nog niet kent weigert en 401 retourneert. De foutmelding vermeldt dan de oude provider, wat een nuttige aanwijzing is.
- Je stelt de nieuwe base URL in, maar laat een oude sleutel in de omgeving achter. Het verzoek bereikt ons, en wij weigeren de sleutel van de andere provider.
Controleer ook het pad. De base URL eindigt al op /v1, dus SDK's voegen hier /chat/completions aan toe. Als je de URL zelf bouwt, is het volledige pad /v1/chat/completions, niet /v1/v1/chat/completions.
Oorzaak 4: omgevingsvariabelen en configuratiebestanden
Als curl werkt maar je app faalt, dan krijgt je app een andere sleutel te zien dan je denkt.
- Variabele niet geëxporteerd. In een shell werkt
API_KEY=abc python app.py, maarAPI_KEY=abcop een eigen regel bereikt geen childprocessen. Gebruikexport. - Overschaduwd door een andere waarde. Bibliotheken kunnen
OPENAI_API_KEYautomatisch lezen. Als er een oude staat ingesteld in je shellprofiel, kan deze je bedoelde waarde overschrijven. - Aanhalingstekens in een .env-bestand. Sommige loaders houden de aanhalingstekens als onderdeel van de waarde. Als je sleutel omhuld is door aanhalingstekens, verwijder ze dan of test met de repr-check hierboven.
- Niet opnieuw gestart. Servers en notebooks lezen omgevingsvariabelen bij het opstarten. Start opnieuw op na het bewerken.
- Andere omgeving in productie. Containers, CI en hosting-dashboards hebben elk hun eigen variabeleopslag. Print de sleutellengte, nooit de sleutel zelf, in de logs.
Een minimale Python-check die de configuratie bewijst
Dit script gebruikt de OpenAI SDK en rapporteert duidelijk als authenticatie faalt:
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"))
Als dit een X-Request-Id afdrukt, voeg het dan toe als je support schrijft, zodat het team je verzoek kan vinden. Dezelfde check voor andere talen staat in de quickstart voor vijf talen.
401 versus andere fouten
Besteed geen tijd aan authenticatie als de fout iets anders is. Een korte kaart:
| Code | Gewone betekenis | Waar te zoeken |
|---|---|---|
| 401 | Ontbrekende of ongeldige sleutel | Koptekst, sleutel, basis-URL |
| 429 | Rate limit of tijdelijke overbelasting | Wacht even en probeer het opnieuw; zie de docs voor limieten |
| 400 | Foutief request body | JSON, modelnaam, parameters |
| 404 | Verkeerd pad | Basis-URL en endpoint |
Controleer ook de modelnaam. Gebruik uncensored exact; een verkeerde model-ID is een requestfout, geen 401. Specifieke details, waaronder de endpoints en kopteksten die de API accepteert, staan op de pagina OpenAI-compatibele API-specificatie.
Proxies, browsers en laatste redmiddel
Twee configuraties veroorzaken 401-fouten die mysterieus lijken.
Proxies en gateways
Een reverse proxy, API-gateway of serverless wrapper tussen jouw app en de API kan de Authorization koptekst verwijderen of wijzigen. Test vanaf dezelfde machine met curl en vergelijk. Sommige frameworks sturen de koptekst ook alleen door naar hosts van dezelfde oorsprong, dus een aangepaste fetch-wrapper kan deze stil verliezen bij een cross-origin call.
Sleutels in front-end code
De API rechtstreeks aanroepen vanuit browser JavaScript blootstelt de sleutel aan iedereen die de ontwikkelaarshulpmiddelen opent, en browsers kunnen het verzoek ook blokkeren om cross-origin redenen die op auth-fouten lijken. Houd de sleutel op een server en laat je front-end jouw eigen endpoint aanroepen, die op zijn beurt de API aanroept met de bijgevoegde sleutel. Als een sleutel ooit in publieke code of een screenshot is geplakt, vervang hem dan.
Nog steeds vastgelopen
Als een vers gekopieerde sleutel nog steeds 401 retourneert in de curl-test, genereer de sleutel dan opnieuw vanuit de API-sleutelpagina, plak hem rechtstreeks in de opdracht en probeer het nog een keer. Als dat faalt, stuur support dan de tijd van het verzoek, het endpoint en de X-Request-Id response koptekst. Stuur de volledige sleutel nooit in een bericht; de eerste en laatste vier tekens zijn genoeg om hem te identificeren.
