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.
- 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.

"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.
| Kod | Genellikle ne demek | Beklemek düzeltir mi? | Ne yapmalı |
|---|---|---|---|
| 401 | Anahtar 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 anahtar | Hayır | Anahtarı 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 var | Hayır | Sağlayıcının faturalandırma sayfasında bakiye yükleyin ya da ödeme yöntemini düzeltin |
| 403 | Anahtar çalışıyor ama izin yok: desteklenmeyen ülke ya da bölge, o modele erişim yok veya bir doğrulama adımı gerekiyor | Hayır | Desteklenen bölgeleri, anahtarın izinlerini ve istenen doğrulamaları kontrol edin |
| 404 | Model adı ya da adres yanlış | Hayır | Başka bir model seçin ya da adresi kontrol edin |
| 429 | Kısa sürede çok fazla istek ya da bazı sağlayıcılarda boş bakiye veya harcama limiti | Hız sınırıysa çoğu zaman evet | Bekleyip yeniden deneyin; mesajda quota, balance, credit ya da spend limit geçiyorsa bakiye yükleyin veya limiti yükseltin |
| 500–504, 529 | Sağlayıcı tarafında bir arıza ya da aşırı yük | Genellikle evet | Sonra 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.
| Sağlayıcı | Bakiye bitince gelen kod | Mesajda ne yazar | Resmi sayfa |
|---|---|---|---|
| OpenAI | 429 | credit_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ür | platform.claude.com/docs/en/api/errors (kodlar); platform.claude.com/docs/en/about-claude/api-credits-for-subscribers (mesaj) |
| Google Gemini | 402 (ön ödemeli faturalandırma) | payment_required; 403 de ödenmemiş bir Cloud Billing bakiyesi anlamına gelebilir | aistudio.google.com/docs/api-errors |
| OpenRouter | 402 | Hesabınızın ya da API anahtarınızın kredisi yetersiz | openrouter.ai/docs/api-reference/errors |
| DeepSeek | 402 | Insufficient Balance | api-docs.deepseek.com/quick_start/error_codes |
| xAI (Grok) | Belirtilmemiş | Ön ödemeli kredi bitince istekler reddedilir | docs.x.ai/console/billing |
| Mistral AI | 402 | Payment required | docs.mistral.ai/resources/error-glossary |
| Groq | Belgelenmemiş | Groq kullanımdan sonra faturalar; hata sayfasında bakiye hatası yok | console.groq.com/docs/errors |
| Together AI | 402 | Payment Required | docs.together.ai/docs/error-codes |
| Fireworks AI | 402 | Payment Required | docs.fireworks.ai/guides/inference-error-codes |
| MiniMax | Belirtilmemiş (iş kodu 1008) | insufficient balance | platform.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) | 403 | Arrearage ya da isv.OUT_OF_SERVICE (hesap borçlu) | alibabacloud.com/help/en/model-studio/error-code |
| Kimi (Moonshot AI) | 429 | exceeded_current_quota_error | platform.kimi.ai/docs/api/errors |
| SiliconFlow | Belgelenmemiş | Listede bakiye hatası yok | docs.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’da görünen | Anlamı | 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ı reddetti | Anahtarı 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ı doldu | Sağ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 yok | Kendi API anahtarınızı ekleyin ya da UTC 00.00’daki sıfırlamayı bekleyin |

Ö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?
API key için 401 hatası ne demek?
402 Payment Required hatası nedir?
429 hatası hız sınırı mı, kota sorunu mu?
OpenAI API key’im neden insufficient_quota diyor?
Doğru kopyaladığım yeni API key neden çalışmıyor?
İ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.