Bu curl testini önce çalıştırın
Kodu değiştirmeden önce uygulamanızı devre dışı bırakın. Bu tek komut, API'ye minimum geçerli isteği gönderir:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models hiçbir maliyet gerektirmez, bu nedenle anahtarı test etmek için güvenli bir yoldur. -i bayrağı durum satırını ve başlıkları yazdırır.
- 200 ve bir model listesi: anahtar iyidir. Uygulamanız farklı bir şey gönderiyor, bu yüzden ortam değişkenleri ve base URL bölümlerine gidin.
- 401: anahtar veya başlık yanlıştır. Bir sonraki bölüme devam edin.
- Bağlantı veya DNS hatası: base URL yanlıştır; bu, 401'den farklı bir sorundur.
Anahtarı değişken üzerinden değil, elle bu teste yapıştırın. Bu, ortam değişkenlerini şüpheliler listesinden çıkarır.
Neden 1: başlık tam doğru değil
API, Authorization: Bearer <key> formatını bekler. Küçük sapmalar hepsi bir LLM API 401 hatasına neden olur:
Authorization: YOUR_KEYBearer kelimesi eksik.Authorization: Bearer: YOUR_KEYekstra bir iki nokta ile.Authorization: Bearer "YOUR_KEY"değer içinde tırnak işaretleri ile.Authorization: Bearer YOUR_KEYiki boşluk ile.X-API-Keyveyaapi-keyyerineAuthorizationadında bir başlık. Bunlar diğer hizmetlerin kurallarıdır.
Bir OpenAI SDK kullanıyorsanız başlığı kendiniz yazmazsınız. SDK, başlığı api_key argümanından oluşturur. Yine de 401 görüyorsanız, SDK'ya geçirilen değer sorundur, başlık formatı değil.
Neden 2: anahtarın kendisi bozuk
Anahtarlar uzun rastgele dizelerdir, bu nedenle kopyalama hataları yaygındır ve gözle fark edilmesi zordur.
- Sondaki satır sonu veya boşluk. Terminalden veya metin dosyasından kopyalama sırasında bu karakterler sıklıkla eklenir. Birçok HTTP kütüphanesi ardından geçersiz bir üst bilgi veya eşleşmeyen bir anahtar gönderir.
- Kesilmiş anahtar. Anahtar kelime seçimini bozan karakterler içeriyorsa çift tıklama yalnızca bir kısmını seçer. Bunun yerine API anahtarı sayfası üzerindeki kopyalama düğmesini kullanın.
- Akıllı tırnaklar. Bir kelime işlemci veya sohbet uygulaması üzerinden yapıştırma, düz tırnakları kıvrık tırnaklarla değiştirebilir.
- Eski veya döndürülmüş anahtar. Yeni bir anahtar oluşturduysanız, eski anahtar artık kullandığınız anahtar olmayabilir.
Python'da görünmez karakterleri kontrol etmek için değerin repr çıktısını yazdırın:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
İkinci satır False yazdırıyorsa, anahtarın etrafında boşluk vardır. Okurken .strip() çağırın.
Neden 3: yanlış base URL
Mevcut bir uygulamayı yeni bir sağlayıcıya geçirirken en yaygın hata budur. Anahtarınız yalnızca onu veren sunucuda geçerlidir. Bu site için base URL şudur:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
İki hata deseni tekrar tekrar ortaya çıkar:
- Yeni anahtarı ayarlarsınız ancak eski base URL'yi bırakırsınız. İstek eski sağlayıcıya gider; bu, daha önce görmediği bir anahtarı reddeder ve 401 döndürür. Hata metni daha sonra eski sağlayıcıyı belirtir ki bu yararlı bir ipucudur.
- Yeni base URL'yi ayarlarsınız ancak ortamda eski bir anahtar bırakırsınız. İstek bize ulaşır ve biz diğer sağlayıcının anahtarını reddederiz.
Yolu da kontrol edin. Base URL zaten /v1 ile bittiğinden, SDK'lar /chat/completions ekler. URL'yi elle oluşturuyorsanız tam yol /v1/chat/completions olmalıdır, /v1/v1/chat/completions değil.
Neden 4: ortam değişkenleri ve yapılandırma dosyaları
curl çalışıyor ama uygulamanız başarısız oluyorsa, uygulamanıza düşündüğünüzden farklı bir anahtar besleyen bir şeyler var.
- Değişken dışa aktarılmamış. Bir kabukta
API_KEY=abc python app.pyçalışır, ancakAPI_KEY=abctek başına bir satırda alt süreçlere ulaşmaz.exportkullanın. - Başka bir değer tarafından gölgelenmiş. Kütüphaneler
OPENAI_API_KEYdeğerini otomatik olarak okuyabilir. Kabuk profilinizde eski bir değer ayarlıysa, kastettiğiniz değerin üzerine yazabilir. - .env dosyasındaki tırnak işaretleri. Bazı yükleyiciler tırnak işaretlerini değerin bir parçası olarak korur. Anahtarınız tırnak karakterleri arasında geliyorsa bunları kaldırın veya yukarıdaki repr kontrolünü kullanın.
- Yeniden başlatılmadı. Sunucular ve not defterleri ortam değişkenlerini başlangıçta okur. Düzenlemeden sonra yeniden başlatın.
- Üretim ortamında farklı ortam. Konteynerler, CI ve barındırma panolarının kendi değişken depoları vardır. Anahtarın kendisini değil, anahtarın uzunluğunu günlüklerde yazdırın.
Yapılandırmayı kanıtlayan minimal Python kontrolü
Bu betik OpenAI SDK'sını kullanır ve kimlik doğrulama hatası oluştuğunda açıkça bildirir:
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"))
Bu, X-Request-Id yazdırıyorsa, ekibin isteğinizi bulabilmesi için destek ile yazışmalarınızda bunu dahil edin. Diğer dillerdeki aynı kontrol, beş dil için hızlı başlangıç sayfasında yer alır.
401 diğer hatalardan farklı
Hata farklı bir şeyse kimlik doğrulama ile zaman harcamayın. Kısa bir harita:
| Kod | Yaygın anlam | Nereye bakılmalı |
|---|---|---|
| 401 | Eksik veya geçersiz anahtar | Başlık, anahtar, base URL |
| 429 | Hız limiti veya geçici aşırı yüklenme | Geri çekilip yeniden deneyin; limitler için dokümantasyon sayfasına bakın |
| 400 | Bozuk istek gövdesi | JSON, model adı, parametreler |
| 404 | Yanlış yol | Base URL ve uç nokta |
Model adını da kontrol edin. uncensored model kimliğini tam olarak kullanın; yanlış model kimliği bir istek hatasıdır, 401 hatası değildir. API'nin kabul ettiği uç noktalar ve üst bilgiler dahil olmak üzere teknik detaylar OpenAI-uyumlu API dokümanı sayfasında yer almaktadır.
Proxy'ler, tarayıcılar ve son çareler
İki kurulum, gizemli görünen 401 hatalarına yol açar.
Proxy'ler ve ağ geçitleri
Uygulamanız ile API arasındaki ters proxy, API ağ geçidi veya sunucusuz sarmalayıcı, Authorization başlığını silebilir veya yeniden yazabilir. curl ile aynı makineden test edin ve karşılaştırın. Bazı çerçeveler başlığı yalnızca aynı kökenli (same-origin) istemcilere iletir; bu nedenle özel bir fetch sarmalayıcısı, kökenler arası bir çağrıda başlığı sessizce kaybedebilir.
Ön uç kodundaki anahtarlar
API'yi doğrudan tarayıcı JavaScript'i üzerinden çağırmak anahtarı geliştirici araçlarını açan herkesin görmesine olanak tanır; tarayıcılar ayrıca kimlik doğrulama hataları gibi görünen kökenler arası (cross-origin) nedenlerle isteği engelleyebilir. Anahtarı bir sunucuda tutun ve ön yüzünüzün kendi uç noktanıza istek göndermesini sağlayın; bu uç nokta da anahtarı ekleyerek API'yi çağırır. Bir anahtar halka açık bir koda yapıştırıldıysa veya bir ekran görüntüsünde yer aldıysa, anahtarı değiştirin.
Hâlâ takıldınız mı
Yeni kopyalanan bir anahtarın bile curl testinde 401 döndürmesi durumunda, anahtarı API anahtarı sayfasından yeniden oluşturun, komuta doğrudan yapıştırın ve bir kez daha deneyin. Bu başarısız olursa, desteğe isteğin zamanını, uç nokta ve X-Request-Id yanıt başlığını gönderin. Anahtarı tam olarak mesajda göndermeyin; tanımlamak için ilk ve son dört karakter yeterlidir.
