kimiapikey.comKılavuz
Kimi API Anahtarı Çalışmıyor: Nedenler, Çözümler, Yedek
Eğer kimi api anahtarı çalışmıyor hatası 401, 404 veya 429 olarak görünüyorsa, neden neredeyse her zaman beş şeyden biridir: yanlış base URL, eşleşmeyen anahtar, bakiye yok, hız limiti veya uç noktanın tanımadığı bir model adı. Bu sırayla ilerleyin.
güncellendi


Temel noktalar
- Bir anahtar yalnızca onu veren sağlayıcıya karşı çalışır, bu nedenle base URL ve anahtar aynı panelden gelmelidir.
- 401 anahtarın reddedildiğini, 404 genellikle kötü bir yolu, 429 ise bir limite ulaştığınızı veya servisin meşgul olduğunu gösterir.
- Başka bir şeyi değiştirmeden önce durum kodunu ve yanıt gövdesini yazdırın.
- Tek bir arızanın uygulamanızı durdurmaması için ikinci bir OpenAI uyumlu uç nokta yapılandırılmış tutun.
Önce durum kodunu okuyun
Herhangi bir şeyi yeniden üretmeden önce sunucunun ne dediğine bakın. Çoğu OpenAI tarzı istemci gövdeyi genel bir istisna arkasına gizler. Hem durumu hem de metni yazdırın.
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
Yanıtın ilk satırı nereye bakmanız gerektiğini gösterir:
| Durum | Yaygın anlam | Şununla başlayın |
|---|---|---|
| 401 | Anahtar reddedildi | Anahtar kopyalama işlemi, anahtar ve base URL farklı sağlayıcılardan |
| 404 | Yol veya model bulunamadı | Eksik /v1, çift yol, yanlış model ID |
| 400 | İstek gövdesi geçersiz | Parametre adları, mesaj formatı, gövde boyutu |
| 429 | Limit aşıldı veya servis meşgul | İstek hızı, eşzamanlı çağrılar, yeniden deneme zamanlaması |
| 5xx | Sunucu tarafı sorunu | Geri çekilme ile yeniden deneyin, ardından yedek uç noktaya geçin |
Eğer hiç HTTP yanıtı almazsanız (zaman aşımı veya DNS hatası), sorun ağ veya yazdığınız ana makine adıdır, anahtar değil.
Temel URL ve anahtar birlikte olmalıdır
Taze bir anahtarın başarısız olmasının en yaygın nedenidir. Anahtarlar sağlayıcı başına verilir. Bir panelden gelen bir anahtar, başka bir sağlayıcının sunucularında bilinmez, bu nedenle geldiği yerde tamamen geçerli olsa bile 401 döndürür.
Bu noktaları kontrol edin:
- Anahtar ve temel URL aynı hesap sayfasından gelir. Anahtarı bir sağlayıcıdan kopyaladıysanız ve yapılandırmanızda eski bir temel URL bıraktıysanız, istek yanlış yere gider.
- Ortam değişkenleri kodunuzun ad alanını gölgelendirmiyor. Açıkça geçmediğinizde OpenAI SDK,
OPENAI_API_KEYveOPENAI_BASE_URLdeğişkenlerini okur; bu nedenle eski bir kabuk değişkeni dosyada yazdığınızı gölgelendirebilir. - Anahtarın sonunda boşluk veya yeni satır yok. Kopyala-yapıştır kaynaklı son yeni satır, 401'in klasik bir nedenidir.
- Başlık tam olarak
Authorization: Bearer <key>şeklindedir. Bazı araçlar anahtarı farklı bir başlıkta bekler ve OpenAI-uyumlu modun açık olması gerekir.
Editörler ve sohbet ön uçları bir tuzak daha ekler. Bunların çoğu "OpenAI temel URL" için ayrı bir alan ve onu etkinleştirmek için ayrı bir geçiş tutar. Geçiş kapalıysa, uygulama sessizce yeni anahtarınızla varsayılan ana makineyi aramaya devam eder ve kötü bir anahtar gibi görünen 401 alırsınız. Ayarları kaydedin, önbelleğe alıyorsa uygulamayı yeniden başlatın ve karmaşık bir şeyi test etmeden önce kısa bir test mesajı gönderin.
Temel URL /v1 ile bitmelidir, ana makineyle veya /v1/chat/completions ile değil. SDK geri kalanını ekler. Tam yolu zaten içeren bir URL, çift yola ve 404'e yol açar.
Bölgesel erişim, proxyler ve kurumsal ağlar
Bazen anahtar iyidir ve istek doğru sunucuya ulaşmaz. Sağlayıcı erişimi, bağlandığınız yere bağlı olabilir ve bir VPN, kurumsal proxy veya güvenlik duvarı kuralı trafiği engelleyebilir veya yeniden yazabilir. Desteklenen bölgeler için sağlayıcının kendi belgelerine veya durum sayfasına bakın ve kuralların başka bir hizmetle aynı olduğunu varsaymayın.
Hızlı bir izolasyon testi: aynı curl komutunu farklı bir ağdan (örneğin bir telefon erişim noktasından) çalıştırın. Eğer orada çalışırsa anahtar doğrudur ve ağınız sorundur. Proxy HTTPS_PROXY ayarlıysa, HTTP kütüphanenizin bunu gerçekten dikkate alıp almadığını kontrol edin; bazı araçlar bunu görmezden gelir ve bağlantı hatası verir.
Bakiye, kota ve hız limitinin nasıl tezahür ettiği
Bir anahtar geçerli olabilir ve hesapta kredi kalmadığı veya kota tüketildiği için istekleri reddedebilir. Kodu hata ayıklamadan önce panoyu kontrol edin. Hiç bakiye yüklemediyseniz, ücretsiz olanakların genellikle küçük ve kısa ömürlü olduğunu unutmayın.
429 farklı bir durumdur. Bu, anahtarın kötü olduğunu değil, sunucunun sizi yavaşlattığını gösterir. Bu sitede tanımlanan uç noktada, tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir; deneme anahtarı ise 2 eşzamanlı ve dakika başına 60 istek izni verir. Bunları aştığınızda API, rate_limited (dakika başına çok fazla istek) veya concurrency (aynı anda çok fazla istek) hata koduyla birlikte HTTP 429 döndürür. Geçici aşırı yüklenme de Retry-After: 5 başlığıyla birlikte 429 döndürür.
Bu sorunların çoğunu iki alışkanlık düzeltir. Var olduğunda Retry-After değerine uyun ve paralel çalışanlarınızı eşzamanlılık limitine kadar sınırlayın. Akışlı bir istek, akış bitene kadar slotunu korur; bu nedenle takılan bir akış, beklendiğinden daha uzun süre sizin aleyhinize sayılır.
Model adı, parametreler ve gövde boyutu
404 veya geçerli bir anahtarla 400, genellikle istekle ilgili sorunlara işaret eder. Kontrol edilecek üç şey:
- Model Kimliği. Her sağlayıcının kendi model isimleri vardır.
GET /v1/modelsuç noktasını sorgulayarak hangi modelleri sunduğunu öğrenin ve yanıtta yer alan kimliği kopyalayın. Bu sitede model kimliğiuncensoredşeklindedir. - Parametreler.
max_tokens,temperatureveresponse_formatgibi isimler standarttır, ancak bir sağlayıcı yalnızca bir alt küme kabul edebilir. İstek geçene kadar isteğe bağlı alanları kaldırın, ardından tek tek geri ekleyin. - Boyut. Çok büyük istemler, model onları görmeden önce gövde limitleri nedeniyle başarısız olabilir. Burada maksimum gövde boyutu 8 MB'tır ve bağlam penceresi istem ile tamamlama birlikte 100.000 token içindir.
Akış, çalışan bir anahtarın bozuk göründüğü başka bir alandır. İstek stream: true olmadan başarılı olup bu değerle başarısız oluyorsa, neden genellikle uç nokta değil, sunucu tarafından gönderilen olayları (SSE) arabelleğe alan veya kesen bir proxy'dir. Onaylamak için akışı kapatın ve ardından proxy ayarlarına bakın.
Sadece model adını değiştirdiniz ve çağrı başarısız olduysa, kurulumunuzun geri kalanının iyi olduğunu onaylamak için eski adı geri koyun.
Bir yedek uç nokta hazır tutun
Sağlıklı bir sağlayıcının da kötü saatleri olabilir. Ürününüz tek bir anahtara bağlıysa, tek bir arıza sizin hizmet kesintiniz haline gelir. OpenAI istek formatı paylaşıldığından, ikinci bir uç nokta yapılandırıp birkaç satır kodla geçiş yapabilirsiniz.
Bu sitedeki uç nokta OpenAI uyumludur, bu nedenle ikinci bir sağlayıcı olarak uyar. Bağımsız barındırılan açık ağırlıklı bir modeldir, Moonshot'un resmi hizmeti değildir ve bir Kimi modelinden farklı yanıt verecektir, bu nedenle buna güvenmeden önce istemlerinizi test edin. İşte birinciyi önce deneyen ve hatalarda yedek geçen küçük bir sarmalayıcı:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
Fiyatlandırma kullandıkça öde esasına göredir: ön ödemeli krediden 1M girdi token başı $0,15 ve 1M çıktı token başı $0,50. Başarısız veya reddedilen istekler için ücret alınmaz; bu nedenle nadiren çalışan bir yedek mekanizmayı tutmak neredeyse maliyetsizdir. Bakiye yükleme $20'den başlar; bonus seviyeleri için fiyatlandırma sayfasına bakın.
Yedek uç nokta mekanizmasını iki dakika içinde test edin
Yeni kullanıcılar, kayıt olduktan sonra API anahtarı sayfası üzerinde tek tıkla $0,50 deneme kredisi talep edebilir. Kredi için kart gerekmez ve 7 gün boyunca geçerlidir; bu süre, gerçek istemlerinizi uç noktada bir kez çalıştırmak için yeterlidir. Ardından aşağıdaki duman testini çalıştırın.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Kalan kredinizi görmek için X-Balance-USD yanıt başlığına bakın. Tam istek referansı dokümantasyonda yer alır. Bunu bir editöre bağlıyorsanız, Cursor'da Kimi tarzı bir API anahtarı kullanma rehberi temel URL alanının nerede olduğunu gösterir ve Kimi API anahtarı genel bakışı bu uç noktanın kullandığınız modelle nasıl ilişkili olduğunu açıklar.
Daha fazla kılavuz
- Moonshot API Base URL: Durumunuzu Başka Yere Yönlendirin
- Cursor'da Kimi Tarzı API Anahtarı Kullanma: Kurulum Kılavuzu
Sıkça Sorulan Sorular
Model, Moonshot'un resmi Kimi'si ile aynı mı?
Hayır, sansürsüz olması için ayarlanmış açık ağırlıklı bir model barındırıyoruz. Bu bir GPT, Claude, Gemini, Grok, DeepSeek veya başka bir tedarikçinin modeli değildir. Kendi sunucularımızda çalışan ayrı bir modeldir.
Verilerimle eğitim yapıyor musunuz?
Hayır. İstemleriniz ve tamamlamalarınız eğitim için kullanılmaz. Gizliliğe ve şeffaflığa değer veriyoruz, bu nedenle verileriniz size ait kalır.
Hız limitleri nelerdir?
Her anahtar başına dakikada 300 istekle sınırlısınız. Maksimum istek gövdesi boyutu 8 MB'tır. Bu limitler, tüm kullanıcılar için kararlı performansın sağlanması için tasarlanmıştır.
İçerik politikası nedir?
Model, yetişkinlere yönelik, tartışmalı ve yaratıcı konular konusunda sansürsüzdür. Ancak biz reşit olmayanlarla ilgili cinsel içerikleri engelleriz. Bu, abonelik seviyenizden bağımsız olarak her zaman geçerli olan katı bir sınırlamadır.
Sorular ve cevaplar
Yeni anahtarım neden hemen 401 döndürüyor?
En yaygın nedenler, anahtarın farklı bir sağlayıcının Base URL'ine gönderilmesi, kopyalanan anahtardaki boşluk veya yeni satır karakteri veya kodunuzu geçersiz kılan ortam değişkenidir. SDK'nızı elemek için curl ile test edin.
429, kötü bir anahtar ile aynı mıdır?
Hayır. 429, bir hız limitine, bir eşzamanlılık limitine veya geçici bir aşırı yüklenmeye ulaştığınızı gösterir. Anahtar geçerlidir. Retry-After değerini bekleyin ve paralel isteklerinizi azaltın.
Başarısız istekler için burada para öder misiniz?
Hayır. Başarısız veya reddedilen istekler bu uç noktada ücretlendirilmez; bu nedenle bozuk bir çağrıyı yeniden denemek kredinizi tüketmez.
Bu uç noktayı Kimi modeli için doğrudan değiştirmeden kullanabilir miyim?
Aynı OpenAI istek formatını kullanır, bu nedenle kod değişikliği Base URL, anahtar ve model ID uncensored ile sınırlıdır. Arka plandaki model farklıdır, bu nedenle yanıtlar eşleşmeyebilir; istemlerinizi önce test edin.
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.