API key sorun giderme

API key çalışmıyor mu? 401, 402, 403 ve 429 hata çözümleri

Yapay zekâ API anahtarı neden çalışmaz: 401, 402, 403 ve 429 ne demek, hangi sağlayıcı boş bakiye için hangi kodu kullanır ve her biri nasıl çözülür.

Güncelleme
  • Bir yapay zekâ API anahtarı (API key) "çalışmıyorsa" nedenini hata numarası söyler: 401 anahtarın kendisinin yanlış olduğunu, 402 genellikle bakiyenizin ya da kredinizin bittiğini, 403 anahtarın o işlem için izni olmadığını, 429 ise çok fazla istek gönderildiğini ya da bazı sağlayıcılarda bakiyenin boş olduğunu gösterir.
  • Sağlayıcılar boş bakiye için aynı kodu kullanmıyor. DeepSeek, OpenRouter, Mistral, Together, Fireworks ve Gemini’nin ön ödemeli faturalandırması 402; OpenAI, Kimi ve Z.ai 429; Alibaba Cloud’un Qwen’i 403 kullanır. Yalnızca numaraya değil, mesaja da bakın.
  • Bakiye hataları beklemekle geçmez; hız sınırları genellikle geçer. Aşağıdaki tablo her sağlayıcının resmi hata sayfasını listeliyor; sayfalar 18 Kasım 2026’da kontrol edildi.
iPhone’da Oriveo: bağladığınız sağlayıcıları ve bu ayki harcamayı gösteren sağlayıcı ekranı.

"API key çalışmıyor" aslında ne demek?

API anahtarı, bir uygulamanın her istekle gönderdiği gizli koddur; yapay zekâ sağlayıcısı böylece sizin olduğunuzu ve ücretin hangi hesaba yazılacağını bilir. Bir şey ters gittiğinde sağlayıcı bir hatayla yanıt verir: HTTP durum kodu denen üç haneli bir sayı ve kısa bir mesaj.

Sayı sorunun türünü, mesaj ayrıntıyı söyler. Oriveo yaygın hataları "Geçersiz API Anahtarı" ya da "Sağlayıcı kotası doldu" gibi anlaşılır başlıklara çevirir; bunlar sayfanın aşağısında açıklanıyor.

Hızlı rehber: 401, 402, 403, 429 ve 5xx

Buradan başlayın. Numaranızı bulun, sonra aşağıdaki ilgili bölümü okuyun. Bu özet, 18 Kasım 2026 itibarıyla OpenAI, Anthropic ve diğer sağlayıcıların hata sayfalarına dayanıyor.

Hızlı rehber: 401, 402, 403, 429 ve 5xx
KodGenellikle ne demekBeklemek düzeltir mi?Ne yapmalı
401Anahtar yanlış: eksik bir karakter, fazladan bir boşluk, silinmiş bir anahtar ya da başka bir sağlayıcıya veya bölgeye ait bir anahtarHayırAnahtarı yeniden kopyalayın ya da yenisini oluşturun; sağlayıcıyı ve bölgeyi kontrol edin
402Ödeme gerekiyor: ön ödemeli bakiyeniz ya da krediniz bitti veya bir faturalandırma sorunu varHayırSağlayıcının faturalandırma sayfasında bakiye yükleyin ya da ödeme yöntemini düzeltin
403Anahtar çalışıyor ama izin yok: desteklenmeyen ülke ya da bölge, o modele erişim yok veya bir doğrulama adımı gerekiyorHayırDesteklenen bölgeleri, anahtarın izinlerini ve istenen doğrulamaları kontrol edin
404Model adı ya da adres yanlışHayırBaşka bir model seçin ya da adresi kontrol edin
429Kısa sürede çok fazla istek ya da bazı sağlayıcılarda boş bakiye veya harcama limitiHız sınırıysa çoğu zaman evetBekleyip yeniden deneyin; mesajda quota, balance, credit ya da spend limit geçiyorsa bakiye yükleyin veya limiti yükseltin
500–504, 529Sağlayıcı tarafında bir arıza ya da aşırı yükGenellikle evetSonra yeniden deneyin ya da model değiştirin

Neden yetersiz bakiye ya da kota yazıyor?

Çoğu sağlayıcı, API’nin çalışması için ön ödemeli kredi ya da etkin bir ödeme yöntemi ister ve her biri boş bakiyeyi kendi yöntemiyle bildirir. Bunların hiçbirini yeni bir anahtar düzeltmez; kredi eklemek düzeltir.

Aşağıda Oriveo’nun 15 yerleşik sağlayıcısının, bakiyeniz ya da krediniz bittiğinde belgelediği kod var. "Belirtilmemiş", sağlayıcının 18 Kasım 2026’da kontrol edilen belgelerinin bu durum için bir HTTP kodu vermediği anlamına gelir.

Neden yetersiz bakiye ya da kota yazıyor?
SağlayıcıBakiye bitince gelen kodMesajda ne yazarResmi sayfa
OpenAI429credit_balance_exhausted (hata türü hâlâ insufficient_quota olabilir)developers.openai.com/api/docs/guides/error-codes
Anthropic (Claude)Belirtilmemiş"Your credit balance is too low to access the Anthropic API"; ödeme sorunları 402 billing_error döndürürplatform.claude.com/docs/en/api/errors (kodlar); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (mesaj)
Google Gemini402 (ön ödemeli faturalandırma)payment_required; 403 de ödenmemiş bir Cloud Billing bakiyesi anlamına gelebiliraistudio.google.com/docs/api-errors
OpenRouter402Hesabınızın ya da API anahtarınızın kredisi yetersizopenrouter.ai/docs/api-reference/errors
DeepSeek402Insufficient Balanceapi-docs.deepseek.com/quick_start/error_codes
xAI (Grok)BelirtilmemişÖn ödemeli kredi bitince istekler reddedilirdocs.x.ai/console/billing
Mistral AI402Payment requireddocs.mistral.ai/resources/error-glossary
GroqBelgelenmemişGroq kullanımdan sonra faturalar; hata sayfasında bakiye hatası yokconsole.groq.com/docs/errors
Together AI402Payment Requireddocs.together.ai/docs/error-codes
Fireworks AI402Payment Requireddocs.fireworks.ai/guides/inference-error-codes
MiniMaxBelirtilmemiş (iş kodu 1008)insufficient balanceplatform.minimax.io/docs/api-reference/errorcode
Z.ai (GLM)429 (kod 1113)Insufficient balance or no resource package. Please recharge.docs.z.ai/api-reference/api-code
Qwen (Alibaba Cloud)403Arrearage ya da isv.OUT_OF_SERVICE (hesap borçlu)alibabacloud.com/help/en/model-studio/error-code
Kimi (Moonshot AI)429exceeded_current_quota_errorplatform.kimi.ai/docs/api/errors
SiliconFlowBelgelenmemişListede bakiye hatası yokdocs.siliconflow.com/en/faqs/error-code

401: geçersiz API key ya da kimlik doğrulama hatası

401, sağlayıcının anahtarı tanımadığı anlamına gelir. Tipik mesajlar şunlardır: "Incorrect API key provided" (OpenAI), "authentication_error" (Anthropic), "Authentication Fails" (DeepSeek) ve "Invalid API key: this is not an OpenRouter API key" (OpenRouter).

  • Anahtarı sağlayıcının sitesinden yeniden kopyalayın; eksik karakter olup olmadığına ve başta ya da sonda boşluk kalıp kalmadığına bakın.
  • Anahtarın seçtiğiniz sağlayıcıya ait olduğundan emin olun. OpenAI anahtarı OpenRouter anahtarı olarak çalışmaz, tersi de geçerlidir.
  • Kimi, MiniMax ve Qwen ayrı bölgesel platformlar işletir; birinden alınan anahtar ötekinde çalışmaz. Oriveo’da "Resmi Uç Nokta" seçicisinden (iPhone’da "Resmî istek URL'si") eşleşen bölgeyi seçin.
  • Anahtar silindiyse, iptal edildiyse ya da süresi dolduysa yenisini oluşturun.

402: ödeme gerekli ya da yetersiz bakiye

402 parayla ilgilidir: ön ödemeli bakiye boştur ya da ödeme yöntemi başarısız olmuştur. Sağlayıcının faturalandırma sayfasında bakiye yükleyin ya da ödeme bilgilerinizi güncelleyin, sonra yeniden gönderin. Beklemek işe yaramaz.

Oriveo’da bu hata "Sağlayıcı kotası doldu" başlığıyla şu mesajla görünür: "Sağlayıcı, bu API anahtarının kotasının veya kredisinin bittiğini bildiriyor. Sağlayıcıdaki faturanızı kontrol edin veya model değiştirin."

403: erişim yasak ya da izin reddedildi

403, sağlayıcının anahtarı tanıdığı ama isteğe izin vermediği anlamına gelir. Nedeni sağlayıcıya göre değişir:

  • OpenAI, API desteklemediği bir ülkeden kullanıldığında "Country, region, or territory not supported" döndürür. Her sağlayıcı desteklediği ülkelerin listesini yayımlar.
  • Gemini; ücretsiz plandaki bir projenin doğrulanması gerektiğinde (FREE_TIER_VERIFICATION_REQUIRED), bağlı Cloud Billing hesabında ödenmemiş bakiye olduğunda ya da Google sızdığı bildirilen bir anahtarı engellediğinde 403 döndürür.
  • Anthropic, anahtar o kaynağı kullanamıyorsa permission_error döndürür; kuruluş (organization) ve çalışma alanı (workspace) ayarlarınızı kontrol edin.
  • OpenRouter, bir istek izinler, moderasyon, bir koruma kuralı ya da bütçe limiti tarafından engellendiğinde 403 döndürür.
  • SiliconFlow bazı modeller için kimlik doğrulaması ister.
  • Qwen 403’ü borçlu hesaplar için ve ücretsiz kota bitmişken "Free Quota Only" ayarı açıksa AllocationQuota.FreeTierOnly için kullanır.

429: çok fazla istek, hız sınırı ya da kota aşıldı

429 çoğu zaman kısa sürede çok fazla istek ya da token gönderdiğiniz anlamına gelir. Buna hız sınırı (rate limit) denir ve birkaç on saniye beklerseniz geçer. Yanıtta bir Retry-After süresi varsa o kadar bekleyin.

Bazı sağlayıcılar boş bakiye ya da harcama limiti için de 429 kullanır ve bunlar beklemekle geçmez: OpenAI (credit_balance_exhausted ya da kendi koyduğunuz bir harcama limiti), Kimi (exceeded_current_quota_error), Z.ai (kod 1113) ve bir kuruluş aylık harcama limitine ulaştığında Anthropic (enforced_spend_limit_reached). Anthropic’teki bu durum, daha üst bir kademe talep etmezseniz sonraki aya kadar sürer.

Ücretsiz planlar daha sıkıdır. Gemini’nin ücretsiz planında ve OpenRouter’ın ücretsiz modellerinde dakikalık ve günlük limitler var.

Oriveo’da hız sınırı web’de "Oran Sınırlı", iPhone ve Android’de "Sağlayıcı Oranı Sınırlı" olarak görünür. Mesajda kota ya da kredi geçiyorsa Oriveo bunun yerine "Sağlayıcı kotası doldu" gösterir.

Oriveo’nun hata mesajları ne anlama geliyor?

Oriveo’nun Türkçe arayüzünde görebileceğiniz mesajlar şunlar:

Oriveo’nun hata mesajları ne anlama geliyor?
Oriveo’da görünenAnlamıNe yapmalı
Kaydedildi, ancak anahtar geçersiz görünüyor. Daha sonra sağlayıcı ayarlarında doğrulayabilirsiniz.Oriveo sağlayıcıyı kaydetti, ama sağlayıcı kontrol sırasında anahtarı reddettiAnahtarı yeniden kopyalayın ve o sağlayıcının ayarlarında güncelleyin
Geçersiz API AnahtarıSağlayıcı 401 ya da 403 döndürdüAnahtarı kontrol edin ya da değiştirin; 403 ise bölgeyi ve izinleri kontrol edin
Sağlayıcı kotası dolduSağlayıcı, bu anahtarın kredisinin ya da kotasının bittiğini söylüyor (402 ya da kotadan söz eden 429)Sağlayıcıda bakiye yükleyin ya da başka bir modele geçin
Oran Sınırlı (web) / Sağlayıcı Oranı Sınırlı (iPhone ve Android)Şimdilik çok fazla istek var (429)Biraz bekleyip yeniden deneyin
Ücretsiz kota doldu (web ve iPhone) / Ücretsiz Kotaya Ulaşıldı (Android)Oriveo Free’nin bugünkü kullanım hakkı bitti; bunun kendi anahtarınızla ilgisi yokKendi API anahtarınızı ekleyin ya da UTC 00.00’daki sıfırlamayı bekleyin
OpenAI, Z.ai, Groq, Gemini ve Anthropic gibi bağlı sağlayıcıları harcamalarıyla listeleyen Oriveo Sağlayıcılar ekranı
Anahtarını kontrol etmek ya da değiştirmek için bu listeden bir sağlayıcıyı açın.

Özel uç nokta, relay ya da gateway mi kullanıyorsunuz?

Özel bir uç nokta (custom endpoint) üzerinden bağlanıyorsanız hata o hizmetten ya da arkasındaki sağlayıcıdan gelebilir. Oriveo "Bu bağlantı üst sağlayıcısına ulaşamadı." diyorsa hizmetin sağlayıcıdaki kendi hesabı geçersiz, kredisi bitmiş ya da hız sınırına takılmış olabilir. Sorun sizin yapılandırmanızda değildir; başka bir bağlantıya geçin ya da hizmeti işleten kişiyle iletişime geçin.

Yeni anahtar oluşturmadan önce bunları kontrol edin

Yeni anahtar bir 401’i düzeltir, başka pek bir şeyi değil. Önce şu listeye bakın:

  • Doğru sağlayıcıyı seçtiniz; Kimi, MiniMax, Qwen, SiliconFlow ve Z.ai için doğru bölgeyi de.
  • Anahtarın tamamını, boşluksuz kopyaladınız.
  • Hesapta kredi ya da etkin bir ödeme yöntemi var.
  • Ülkeniz ya da bölgeniz sağlayıcının desteklenenler listesinde.
  • Seçtiğiniz model hesabınıza ya da kademenize açık.

Uygulamayla ilgili sık sorulan sorular

API key’im neden çalışmıyor?
Hata numarasına bakın. 401 anahtarın yanlış olduğunu, 402 bakiyenizin ya da kredinizin bittiğini, 403 isteğe izin verilmediğini (çoğu zaman bölge ya da izinler yüzünden), 429 ise çok fazla istek gönderildiğini ya da bazı sağlayıcılarda bakiyenin boş olduğunu gösterir.
API key için 401 hatası ne demek?
Sağlayıcı anahtarı tanımıyor demektir. Anahtarı boşluksuz yeniden kopyalayın, seçtiğiniz sağlayıcıya ve bölgeye ait olduğunu kontrol edin ya da yeni bir anahtar oluşturun.
402 Payment Required hatası nedir?
Ön ödemeli bakiyeniz ya da krediniz bitmiş veya bir ödeme sorunu var demektir. DeepSeek, OpenRouter, Mistral, Together, Fireworks ve Gemini’nin ön ödemeli faturalandırması bu kodu kullanır. Sağlayıcının faturalandırma sayfasından bakiye yükleyin; beklemek düzeltmez.
429 hatası hız sınırı mı, kota sorunu mu?
İkisi de olabilir. Genellikle kısa bir beklemeden sonra geçen bir hız sınırıdır. Ama OpenAI, Kimi ve Z.ai bakiyeniz boşken de 429 döndürür; mesajda quota, balance ya da credit geçiyorsa beklemek yerine kredi ekleyin.
OpenAI API key’im neden insufficient_quota diyor?
OpenAI API hesabınızda ön ödemeli kredi kalmamış. OpenAI, credit_balance_exhausted koduyla 429 döndürür; hata türü hâlâ insufficient_quota diyebilir. OpenAI’ın faturalandırma ayarlarından kredi ekleyin; yeni anahtar işe yaramaz.
Doğru kopyaladığım yeni API key neden çalışmıyor?
Genellikle hesapta henüz kredi olmadığı ya da faturalandırma kurulmadığı, anahtar başka bir bölgeye ait olduğu veya API ülkenizde sunulmadığı içindir. Başka bir anahtar oluşturmadan önce bunları kontrol edin.

İlgili yazılar

Blogdan

Her anahtar için anlaşılır hata mesajları

Web uygulamasını açın ya da Oriveo’yu iPhone veya Android için indirin, 15 sağlayıcıdan anahtar ekleyin ve bir istek başarısız olduğunda nedenini açıkça görün.

Henüz API anahtarınız yok mu? Oriveo Free ile başlayın.