Ana sayfa → Yardım

401 invalid API key – anahtar doğru göründüğü halde hata veriyorsa

Gördüğünüz hata

• 401 {"code":"INVALID_API_KEY","message":"Invalid API key"}
• AuthenticationError: Error code: 401
• Incorrect API key provided
• You have not supplied a valid API access key
• 401 {"error":{"message":"Invalid API key","type":"invalid_request_error"}}

Neden oluyor

Bunu "JSON yerine HTML" durumundan ayırmak gerekir. Temiz bir JSON 401 almak, base URL'nizin doğru olduğunu ve isteğin düzgün yönlendirildiğini kanıtlar. Yanlış katmanda hata ayıklamak yerine küçük bir düzeltme uzaktasınız.

En yaygın neden aslında yanlış anahtar değil – görünmeyen bir karakterdir. Terminalden ya da web arayüzünden kopyalarken sonda bir satır sonu ya da bölünmez boşluk gelir ve ekranda aynı görünen bir anahtar karşılaştırmada başarısız olur.

Sebebin bu olduğunu doğrulayın

Anahtarın uzunluğunu yazdırın ve panelde gösterilenle karşılaştırın. Bir karakter fazlası ele verir:

# Python
import os
k = os.environ["API_KEY"]
print(len(k), repr(k[-4:]))

# shell
printf '%s' "$API_KEY" | wc -c

repr() çıktısında '\n' görünüyorsa ya da uzunluk beklenenden bir fazlaysa, sebep budur.

Nasıl düzeltilir

1. Boşlukları temizleyinAnahtarı ortam değişkeninden ya da dosyadan okurken kırpın. Sondaki bir satır sonu hiçbir arayüzde görünmez ve her karşılaştırmayı bozar.
2. Başlık adını kontrol edinOpenAI tarzı uç noktalar Authorization: Bearer KEY bekler. Anthropic tarzı uç noktalar x-api-key bekler. Doğru anahtarı yanlış başlıkta göndermek, hangi hatayı yaptığınıza dair hiçbir ipucu vermeden 401 döndürür.
3. Anahtarın neye erişebildiğini kontrol edinAnahtarların bir plana ya da gruba bağlı olduğu ağ geçitlerinde, geçerli bir anahtar kapsamı dışındaki bir model için yine de reddedilebilir. Bazıları daha açık bir hata yerine 401 döndürür. Anahtarın kendisini bozuk sanmadan önce, anahtarınızın gördüğü modelleri listeleyin.
4. Anahtarın hâlâ var olduğunu doğrulayınSilinmiş ve yenilenmiş anahtarlar genellikle 404 değil 401 ile başarısız olur. Yakın zamanda yenilediyseniz, çalışan sürecin yeniden başlatıldığından emin olun – uzun süre çalışan bir süreç eski değeri bellekte tutar.

İlgili konular

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.