TR ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
API anahtarı al

LLM API Hatası 401: Kimlik Doğrulama Sorunlarının Giderilmesi

Bir LLM API 401 hatası, sunucunun isteğinizi doğrulayamadığını gösterir. Neredeyse her durumda sorun istemci tarafındadır: yanlış yazılmış bir başlık, yabancı karakter içeren bir anahtar veya yanlış sunucuya gönderilen bir istek. Bu kılavuz, sorunu en hızlı şekilde bulacak kontrolleri sırasıyla inceler.

Güncellendi

Bir LLM API çağrılırken kimlik doğrulama hatası gösteren parlak bir kilitle eşleşmeyen bir anahtarı simgeleyen görsel

Temel noktalar

  1. 401 bir hız limiti veya fatura hatası değil, bir kimlik doğrulama hatasıdır.
  2. Başlık tam olarak Authorization: Bearer YOUR_KEY olmalıdır; bir boşluk ve tırnak işareti olmadan.
  3. Yanlış base URL'ye gönderilen bir anahtar, yanlış anahtar gibi başarısız olur.
  4. Önce curl ile test edin; curl çalışıyorsa hata uygulamanızın yapılandırmasındadır.

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_KEY Bearer kelimesi eksik.
  • Authorization: Bearer: YOUR_KEY ekstra bir iki nokta ile.
  • Authorization: Bearer "YOUR_KEY" değer içinde tırnak işaretleri ile.
  • Authorization: Bearer YOUR_KEY iki boşluk ile.
  • X-API-Key veya api-key yerine Authorization adı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, ancak API_KEY=abc tek başına bir satırda alt süreçlere ulaşmaz. export kullanın.
  • Başka bir değer tarafından gölgelenmiş. Kütüphaneler OPENAI_API_KEY değ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:

KodYaygın anlamNereye bakılmalı
401Eksik veya geçersiz anahtarBaşlık, anahtar, base URL
429Hız limiti veya geçici aşırı yüklenmeGeri çekilip yeniden deneyin; limitler için dokümantasyon sayfasına bakın
400Bozuk istek gövdesiJSON, model adı, parametreler
404Yanlış yolBase 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.

Sorular ve cevaplar

401 hatası kredimin bitmesi mi anlamına geliyor?

Hayır. 401 kimlik doğrulama ile ilgilidir: anahtar eksik, bozuk veya bilinmiyor. Kredi bitmesi ayrı bir durumdur.

Neden aynı anahtar curl'da çalışıyor ama uygulamamda çalışmıyor?

Uygulamanız muhtemelen farklı bir değer okuyor; örneğin eski bir ortam değişkeni, tırnak işaretli bir .env girdisi veya son boşluklu bir anahtar. Kodunuzun gerçekten kullandığı anahtarın uzunluğunu ve repr çıktısını yazdırın.

Bu API için OpenAI anahtarımı kullanabilir miyim?

Hayır. Her anahtar yalnızca onu veren ana makinede çalışır. API anahtarı sayfasındaki anahtarı, bu sitenin base URL'i ile birlikte kullanın.

401 hatası ücretlendirilir mi?

Hayır. Başarısız veya reddedilen istekler için ücret alınmaz.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al