Ana sayfa → Yardım

Kesinlikle doğru bir anahtarla 401 – başlık formatını kontrol edin

OpenAI uyumlu uç noktalar Authorization: Bearer bekler. Şema eksikse, iki kez yazılmışsa ya da başlıkta fazladan boşluk varsa sunucu bozuk bir kimlik bilgisi görür ve 401 ile yanıt verir – yanlış bir anahtarla aynı yanıt.

Gördüğünüz hata

401 Unauthorized with a key you just copied
invalid_api_key / authentication_error
curl works but the app does not, with the same key
The key works in one client and not another

Neden oluyor

Bazı HTTP istemcileri ve kodsuz araçlar bir "token" ister ve Bearer ön ekini kendileri ekler. Böyle bir alana "Bearer sk-..." yapıştırmak "Bearer Bearer sk-..." üretir.

Bir sohbet penceresinden ya da PDF'ten kopyalamak sonda bir satır sonu ya da bölünmez boşluk getirebilir. Dize ekranda aynı görünür ama ağ üzerinde aynı değildir.

Birkaç ağ geçidi bunun yerine ya da buna ek olarak x-api-key başlığını kabul eder. Anahtarı yanlış başlıkta göndermek, hiç göndermemekten ayırt edilemez.

Sebebin bu olduğunu doğrulayın

İstemcinizin tam olarak ne gönderdiğini, anahtar uzunluğu görünecek şekilde yazdırın:

KEY='paste-here'
echo "length: ${#KEY}"
curl -s -o /dev/null -w '%{http_code}\n' \
  'YOUR_BASE_URL/models' -H "Authorization: Bearer $KEY"

Uzunluk beklediğiniz gibi değilse sorun kopyalamadadır. Burada 200, uygulamanızda 401 görüyorsanız uygulama başlığı farklı oluşturuyordur – yapıştırdığınızı değil, onun gönderdiğini inceleyin.

Nasıl düzeltilir

Şemayı değil, yalnızca anahtarı yapıştırıntoken, key ya da secret etiketli her alana yalnızca anahtarı yapıştırın. Bearer'ı araç ekler.
Okurken boşlukları temizleyinDeğeri ortam değişkeninden ya da dosyadan okurken kırpın. Bir heredoc'tan ya da kopyalanan bir satırdan gelen sondaki satır sonu klasik vakadır.
Anahtarın yenilenmediğini doğrulayınFormat doğruysa konsolda anahtarlarınızı listeleyin ve kullandığınızın hâlâ var ve etkin olduğunu doğrulayın. İptal edilmiş bir anahtar, bozuk formatlı bir anahtarla tamamen aynı şekilde başarısız olur.

APICLAN anahtarları sk- ile başlar ve Authorization: Bearer <key> içine yazılır. Bir anahtar tek bir gruba aittir; sorunsuz kimlik doğrulayan bir anahtar, grubu dışındaki bir modelde yine de 404 verebilir – bu, farklı çözümü olan farklı bir hatadır.

İlgili konular

OpenAI uyumlu bir API'yi çağırırken Unexpected token '<' hatası 401 invalid API key – anahtar doğru göründüğü halde hata veriyorsa

Son kontrol: 2026-10-01. Canlı bir OpenAI uyumlu ağ geçidinde teşhis edilen sorunlardan yazılmıştır, başka sitelerden derlenmemiştir.