TR ▾
API anahtarını al

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

Bir kilitte sıkışmış bir anahtar ve ikinci bir açık kilitte yeşil bir yol gösterir, bu da bir yedek API uç noktasını simgeler
API sunucusuna parlayan bir kablo ile bağlantılı izometrik bir kod editörü illüstrasyonu

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:

DurumYaygın anlamŞununla başlayın
401Anahtar reddedildiAnahtar kopyalama işlemi, anahtar ve base URL farklı sağlayıcılardan
404Yol veya model bulunamadıEksik /v1, çift yol, yanlış model ID
400İstek gövdesi geçersizParametre adları, mesaj formatı, gövde boyutu
429Limit aşıldı veya servis meşgulİstek hızı, eşzamanlı çağrılar, yeniden deneme zamanlaması
5xxSunucu tarafı sorunuGeri ç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_KEY ve OPENAI_BASE_URL değ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:

  1. Model Kimliği. Her sağlayıcının kendi model isimleri vardır. GET /v1/models uç noktasını sorgulayarak hangi modelleri sunduğunu öğrenin ve yanıtta yer alan kimliği kopyalayın. Bu sitede model kimliği uncensored şeklindedir.
  2. Parametreler. max_tokens, temperature ve response_format gibi 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.
  3. 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.

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.

API anahtarı alDokümantasyonu oku