kimiapikey.comKılavuz
Cursor'da Kimi-Tarzı API Anahtarı Kullanımı: Kurulum Kılavuzu
Cursor herhangi bir OpenAI uyumlu uç noktaya bağlanabilir, bu nedenle bu API'ye bağlanmak dört alan ve yaklaşık iki dakika sürer. Bu kılavuz, tam değerleri, anahtarın çalıştığını kanıtlayan bir testi ve en sık karşılaşacağınız hataları kapsar.
güncellendi

Temel noktalar
- Cursor üç değere ihtiyaç duyar: anahtarınız, base URL https://api.kimiapikey.com/v1 ve model adı
uncensored. - Cursor tarafındaki bir sorunu API tarafındaki bir sorundan ayırt etmek için önce anahtarı curl ile test edin.
- Agent tarzı düzenlemeler büyük istemler gönderir, bu nedenle girdi tokenlarına dikkat edin: 1M giriş başı $0,15, 1M çıkış başı $0,50.
- Deneme anahtarı 2 eşzamanlı istek izni verir; Cursor'un agent'ı bunu aşabilir. Tam anahtar 8 eşzamanlı istek izni verir.
Kısa cevap
cursor'da kimi api anahtarını nasıl kullanacağınız için arama yapıyorsanız, bilmeniz gereken ilk şey, başka bir sağlayıcı tarafından verilen bir anahtarın yalnızca o sağlayıcının kendi uç noktasıyla çalıştığıdır. Bu sitedeki anahtar, bu sitenin uç noktasıyla çalışır ve uç nokta OpenAI sohbet tamamlama formatını konuştuğu için Cursor bunu kabul eder. Anahtarı yapıştırın, Cursor'u farklı bir base URL'e yönlendirin ve tek bir özel model adı ekleyin.
Tüm kurulum sırasıyla:
- Bir hesap oluşturun ve API anahtarı sayfası üzerinden anahtarınızı kopyalayın.
- Cursor'u açın, Ayarlar'a gidin, ardından Modeller bölümüne.
- Anahtarı OpenAI API anahtarı alanına yapıştırın.
- Base URL geçersiz kılmasını açın ve
https://api.kimiapikey.com/v1girin. uncensoredadında bir özel model ekleyin ve sohbetten bunu seçin.
Bu makalenin geri kalanı her adımı açıklar, bağlantıyı editör dışında test etmenizi sağlayan bir yol sunar ve genellikle yanlış gidenleri listeler.
Bu anahtarın ne olduğu ve ne olmadığı
Bu site, bağımsız bir sağlayıcı tarafından işletilen ve yasal yetişkin kullanımında içerik reddi olmadan yanıt verecek şekilde ayarlanmış tek bir açık ağırlıklı modele erişim satar. Moonshot, Kimi veya başka bir satıcının resmi API'si değildir ve isteklerinizi başka bir modelin hizmetine yönlendiren bir yönlendirici değildir. Site adı, hizmeti kimin işlettiğinden ziyade insanların ne aradığını yansıtır. Zaten başka bir satıcıdan bir anahtarınız varsa, o satıcının uç noktasıyla kullanmaya devam edin. Bu iki anahtar birbirinin yerine kullanılabilir değildir.
Elde edeceğiniz düz bir OpenAI tarzı API'dir: POST /v1/chat/completions ve GET /v1/models, Bearer token kimlik doğrulama, 100.000 token'lık bağlam penceresi, akış, fonksiyon çağırma ve JSON modu. Sadece metin içerir. Görsel oluşturma, gömme (embedding) ve ince ayar yoktur; bu, editörde önemlidir çünkü bunlara dayanan Cursor özellikleri bu uç noktayı kullanmaz. Kimi API anahtarı açıklayıcısı adlandırmayı ve alternatifleri daha ayrıntılı açıklar.
Kodlama için "sansürsüz" ifadesinin pratik bir anlamı vardır. Model, bir değişken adı veya bir test sabiti hassas göründüğü için bir görevi yarım yolda bırakmaz. Sistemleriniz için güvenlik araçları, çirkin dizelerle dolu log ayrıştırıcıları, web scraper'lar, kurgu üreticileri ve moderasyon test setleri, başka yerlerde reddedilmelere yol açan iş türleridir. Sert sınır yerinde kalır: reşit olmayanları içeren cinsel içerik asla üretilmez.
Cursor'da adım adım kurulum
1. Anahtarı ve deneme kredisi alın
Google veya e-posta ve şifre ile kaydolun. API anahtarı sayfasında tek tıkla $0,50 deneme kredisi talep edebilirsiniz. Kart gerektirmez, 7 gün sürer ve kişi başı bir kez verilir. Bu, birkaç yüz normal sohbet isteği için yeterlidir, bu nedenle hiçbir şey ödemeden bu kılavuzun tamamını bitirebilirsiniz.
2. Model ayarlarını açın
Cursor'da Ayarları açın ve Modeller bölümünü bulun. Menü etiketleri sürümler arasında yer değiştirebilir, bu nedenle bir OpenAI API anahtarı için adlandırılmış bir alan ve OpenAI base URL'ini geçersiz kılmaya ayrılmış bir anahtar veya alan arayın. İlgili iki ayar budur.
3. Üç değeri doldurun
| Cursor alanı | Değer |
|---|---|
| OpenAI API anahtarı | Kontrol panelinizdeki anahtarınız |
| OpenAI base URL'ini geçersiz kıl | https://api.kimiapikey.com/v1 |
| Özel model adı | uncensored |
Base URL'i gösterildiği gibi tam olarak girin. Sonunda /v1 ile biter, son eğik çizgi ve /chat/completions olmadan, çünkü istemci yolu kendisi ekler. Tam yolu içeren yapıştırılmış bir URL 404 hatası üretir ve hata mesajı genellikle nedenini söylemez.
4. Modeli seçin ve mesaj gönderin
Sohbet panelini açın, model listesinden uncensored seçin ve "ISO tarihlerini ayrıştıran bir işlev yaz" gibi küçük bir şey sorun. Bir yanıt akarsa, işiniz bitti demektir. Cursor bir hata gösterirse, ayarları rastgele değiştirmeyin. Bir sonraki bölüme gidin ve uç noktayı doğrudan test edin.
5. Geçersiz kılmanın yan etkisini bilin
Base URL geçersiz kılması, Cursor'da kullandığınız her OpenAI tarzı modele genellikle uygulanır, yalnızca özel olanına değil. Daha sonra standart bir OpenAI modeline geri dönerseniz, önce geçersiz kılmayı kapatın; aksi halde isteğiniz hizmet vermediği bir model adıyla bu uç noktaya gider.
Editöre suç atmadan önce anahtarı test edin
Bir terminalle iki dakika, bir saatlik tahmin yapmaktan iyidir. Bu istek, Cursor'un yaptığı şeyi yapar: bir Bearer token ile bir sohbet tamamlama isteği gönderir.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Bir choices dizisi içeren bir JSON gövdesi, anahtarın, URL'in ve model adının doğru olduğunu gösterir. Yanıt başlıklarını da kontrol edin. X-Balance-USD kalan kredinizi gösterir ve X-Request-Id bir istek izlemeniz gerekirse tutulmaya değerdir.
Resmi OpenAI SDK'sı ile Python'da aynı kontrol:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Modelleri GET /v1/models ile de listeleyebilirsiniz. Cursor ve benzeri istemciler, bir doğrula butonuna bastığınızda bunu bazen çağırır, bu nedenle çalışan bir models çağrısı iyi bir işarettir. Curl çalışır ve Cursor çalışmazsa, sorun editör ayarlarındadır ve aşağıdaki hata tablosu yaygın olanları kapsar.
Model editörünüzde kod yazdığında ne değişir
Yan paneldeki sohbet ucuzdur. Bağlamı birkaç yüz token olan kısa bir soru, bir kuruşun çok altında bir maliyet yaratır. Dosyaları, arama sonuçlarını ve konuşma geçmişini ekleyen editör özellikleri daha pahalıdır çünkü her istek her şeyi tekrar taşır. Modelin, istem ve yanıt arasında paylaşılan 100.000 tokenlık bir penceresi vardır ve Cursor büyük bir klasör eklerseniz bunun çoğunu doldurmak için çekinmez.
İşte gerçek bir hesaplama. Diyelim ki bir istek 40.000 girdi tokenı taşır ve model 1.500 token geri yazar:
- Girdi: 40.000 / 1.000.000 x $0,15 = $0,006
- Çıkış: 1.500 / 1.000.000 x $0,50 = $0,00075
- Toplam: İstek başına $0,00675, yani 100 böyle istek $0,675'e mal olur
Bu, yoğun bir öğleden sonra için bir doların çok altındadır, ancak girdi tarafı baskın olduğu için tasarruf sağlayan alışkanlık daha kısa soru sormak değil, daha az dosya eklemektir. Konu değiştiğinde yeni bir sohbet başlatın, çünkü eski geçmiş her adımda tekrar ödenir.
Fonksiyon çağırma API tarafından desteklenir; bu, agent tarzı editör özelliklerinin dayandığı şeydir. Model bir aracı çağırmaya karar verir, istemciniz onu çalıştırır ve sonucu role: "tool" mesajı olarak döndürür. Herhangi bir modelin çok adımlı bir agent'ı ne kadar iyi yönettiği modele bağlıdır, bu nedenle bir refaktör devretmeden önce küçük bir görevle deneyin. API'nin arkasındaki tek açık ağırlıklı model, bir menüden seçim yapmak yerine tek bir davranış almanızı sağlar.
Cursor'un kendi modelleri üzerinde çalışan Cursor özellikleri (sekme tamamlama gibi) genellikle özel bir anahtarla değiştirilmez. Hangi özelliklerin özel bir OpenAI tarzı uç nokta kabul ettiğini gösteren liste sürümler arasında değiştiğinden, Cursor'un güncel belgelerine bakın.
Yaygın hatalar ve nasıl düzeltilecekleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 404 veya "bulunamadı" | Base URL uç nokta yolunu içeriyor veya /v1 eksik | Tam olarak https://api.kimiapikey.com/v1 kullanın |
| 401 yetkisiz | Yapıştırılan anahtarın içinde ekstra boşluk veya yeni satır var ya da eski bir anahtar | Anahtarı kontrol panelinden tekrar kopyalayın ve tekrar yapıştırın |
| Model bulunamadı | Model adı farklı yazılmış | uncensored kullanın, küçük harfle, başka hiçbir şey yok |
Kod concurrency ile 429 | Anahtarınız için aynı anda çok fazla istek gönderildi | Devam eden isteklerin bitmesini bekleyin veya tam anahtar kullanın (8 eşzamanlı) |
Kod rate_limited ile 429 | Dakika başına izin verilen miktarın üzerinde | Hızı düşürün; deneme anahtarları dakikada 60, tam anahtarlar dakikada 300 istek izni verir |
Retry-After: 5 üstbilgisi ile 429 | Geçici aşırı yüklenme | Beş saniye sonra tekrar deneyin |
| Doğrula butonu başarısız oluyor, curl çalışıyor | Editör, bildiği bir model adıyla test yapar | Doğrulama adımını atlayın ve gerçek bir sohbet mesajı gönderin |
Eşzamanlılık hatası, deneme anahtarında kullanıcıları şaşırttığı için bir notu hak eder. Deneme, 2 eşzamanlı istek izni verir ve paralel olarak birkaç işlem başlatan bir ajan, siz bir şey yapmadan bu sınırı aşabilir. Akışlı bir yanıt da akış bitene kadar slotunu tutar, bu nedenle uzun bir yanıt bir slotu tüm süre boyunca meşgul eder. Tam anahtar, dakikada 300 istek ve 8 eşzamanlı istek izni verir ki bu, bir geliştirici için rahat bir sınırdır.
Başarısız ve reddedilen istekler için ücret alınmaz, bu nedenle bir hatadan sonra yeniden denemek ek maliyet gerektirmez. Tam limitleri belgelendirme sayfasında okuyabilirsiniz.
Deneme süresi dolduğunda bunun için ödeme yapmak
Abonelik yoktur. Ön ödemeli krediyi $20 ile $500 arasında herhangi bir tam tutarla bakiye yükleyebilirsiniz ve istekler krediyi 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50 oranında düşürür. Kredi asla sona ermez, bu nedenle kodlama yapmadığınız bir ay hiçbir maliyet gerektirmez. $50 veya daha fazla olan bakiye yükleme işlemleri bonus taşır: $50'den +%5, $100'den +%10 ve $200'den +%15. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz. fiyatlandırma sayfası güncel sayıları tek bir yerde listeler.
Daha önceki 40.000 girdili, 1.500 çıktılı istek kullanılarak, $20'lik bir bakiye yükleme yaklaşık 2.960 böyle isteği karşılar ($20 / $0,00675). Çoğu editör isteği daha küçüktür, bu nedenle gerçek rakam daha yüksektir. İstemleriniz eğitim için kullanılmaz; bu, yapıştırdığınız kod bir müşteriye aitse önemlidir.
Kurulumu tamamladığınızda, mantıklı bir ilk görev, hızlıca gözden geçirebileceğiniz küçük bir görev olmalıdır: mevcut bir işlev için birim test, uzun bir yorum içeren bir regex veya gürültülü bir dosyanın yeniden yazılması. Sonuçlar iş akışınıza uygunsa kredi ekleyin. Uygun değilse, deneme kredisi ile birkaç sent harcayarak keşfetmiş olursunuz.
Daha fazla kılavuz
- Kimi API Anahtarı Fiyatlandırması: Bu Alternatifin Maliyeti
- Kimi API Anahtarı: OpenAI SDK'ları ve LangChain ile Entegrasyonu
- Kimi API Anahtarı: Nasıl Çalışır ve Alternatifler Nelerdir
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, reşit olmayanlarla ilgili cinsel içerikler engellenir. Bu, abonelik seviyenizden bağımsız olarak her zaman geçerli olan katı bir sınırlamadır.
Sorular ve cevaplar
Moonshot veya Kimi anahtarını bu base URL ile Cursor'a koyabilir miyim?
Hayır. Bir anahtar, yalnızca onu veren sağlayıcının uç noktasıyla çalışır. Anahtarınızı buradaki kontrol panelinizden kullanın veya diğer anahtarı kendi sağlayıcısının URL'siyle birlikte koruyun.
Cursor'da hangi model adını gireceğim?
uncensored girin, küçük harfle. Bu API'nin sunduğu tek model ID'sidir ve farklı bir isim model bulunamadı hatası döndürür.
Cursor'un ajan moduyla çalışıyor mu?
API, ajan özelliklerinin ihtiyaç duyduğu fonksiyon çağırmayı destekler. Modelin uzun çok adımlı görevleri ne kadar güvenilir tamamladığı değişkenlik gösterir, bu nedenle büyük bir görevden önce küçük bir görevde test edin.
Deneme anahtarında neden 429 hatası alıyorum?
Deneme anahtarı 2 eşzamanlı istek ve dakika başına 60 istek izni verir. Tam anahtar 8 eşzamanlı ve dakika başına 300 istek izni verir ve Retry-After: 5 başlığı, yeniden deneyebileceğiniz kısa bir aşırı yüklenme anlamına gelir.
Kodum eğitim için kullanılıyor mu?
Hayır. API'ye gönderilen istemler eğitim için kullanılmaz.
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.