TR ▾
API anahtarı al

cursorapikey.com/Kılavuz

Cursor API Anahtarı Çalışmıyor: Özel Uç Nokta Çözümleri

Cursor API anahtarları çalışmadığında, neden neredeyse her zaman dört nedenden biridir: base URL, model adı, anahtarın kendisi veya hesapta bir limit. Tek bir curl komutu hangisi olduğunu söyler.

güncellendi

Parlayan bir anahtarın yerleştirildiği soyut kod editörü paneli, yanında bir anahtar ve büyüteç
Cursor'a alternatif seçmeyi gösteren editör, sunucu ve terminal için izometrik bir çatallanma

Temel noktalar

  • Anahtarı önce Cursor dışında curl ile test edin; curl çalışırsa sorun Cursor ayarlarındadır.
  • Temel URL https://api.cursorapikey.com/v1 olmalı ve model adı tam olarak uncensored olmalıdır.
  • 401 kötü bir anahtar, 404 kötü bir URL, 429 bir hız veya eşzamanlılık limiti ve bir model hatası yanlış bir model adı anlamına gelir.
  • Menü etiketleri Cursor sürümleri arasında değişir, bu nedenle tam kelime eşleşmesinden ziyade alan amacını eşleştirin.

Adım 1: Anahtarı Cursor dışında test edin

Cursor'u resmin dışında bırakın. Düz bir istek çalışırsa, anahtarınız ve hesabınız iyidir ve hata editör ayarlarındadır. Başarısız olursa, hata gövdesi sorunu belirtir.

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

-i bayrağı durum satırını ve başlıkları yazdırır. 200 durumu ve choices dizisi başarı anlamına gelir. X-Balance-USD başlığı kalan kredinizi gösterir; yetkilendirme veya ödeme hatası alırsanız kontrol edilecek ilk şey budur.

Modelleri de listeleyebilirsiniz, bu da herhangi bir harcama yapmadan anahtarı doğrular:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

Yanıt, model ID'si uncensored içermelidir.

Adım 2: Cursor'daki alanları ayarlayın

Cursor'un ayarlarını açın ve Modeller bölümünü bulun. Üç değere ihtiyacınız var ve bunlardan herhangi birindeki hata, kırık bir anahtar hatasına benzeyen bir arızaya yol açar.

  1. OpenAI API anahtarı: anahtarınızı başında veya sonunda boşluk veya satır sonu olmadan yapıştırın.
  2. OpenAI base URL'sini geçersiz kıl: geçersiz kılma işlevini açın ve https://api.cursorapikey.com/v1 girin. /v1'i koruyun ve /chat/completions'i bırakın.
  3. Özel model: uncensored adında bir model ekleyin ve etkinleştirin. Cursor'ın, uç noktanın tanımadığı bir modeli seçmemesi için kullanmadığınız modelleri devre dışı bırakın.

Kaydettikten sonra, sürümünüzde bir doğrulama seçeneği varsa onu kullanın, ardından sohbet modelinde uncensored seçin. Eski bir sekme başladığı modeli koruyabileceğinden, yeni bir sohbet sekmesi iyi bir testtir. Cursor API nasıl kullanılır'daki adım adım rehber aynı kurulumu daha fazla bilgiyle gösterir.

Hatayı düzeltme ile eşleştirin

Ne görürsünüzOlası nedenÇözüm
401, "geçersiz anahtar", "yetkisiz"Anahtar yanlış yazıldı, kesildi veya iptal edildiAnahtar sayfasından tekrar kopyalayın; son boşluklar için kontrol edin
404, "bulunamadı"Yanlış URL, eksik /v1 veya çift yolTam olarak https://api.cursorapikey.com/v1 kullanın
"model bulunamadı" veya benzeriModel adı uncensored ile uyuşmuyorO tam adla, küçük harfle özel modeli ekleyin
rate_limited ile 429Dakika başına istek sınırının üzerine çıkmaHızı düşürün; deneme anahtarları dakikada 60, tam anahtarlar dakikada 300 istek izni verir
concurrency ile 429Aynı anda çok fazla istekParalel ajan çalıştırmalarını azaltın; deneme 2, tam anahtar 8
429 ile Retry-After: 5Geçici aşırı yüklenmeBeş saniye bekleyin ve yeniden deneyin
curl'de çalışır, Cursor'da başarısız olurAyar kaydedilmedi, yanlış sekme modeli veya özel anahtarları kullanmayan özellikSonraki bölüme bakın

Başarısız veya reddedilen istekler için ücret alınmaz, bu nedenle hata ayıklama sırasında yeniden denemenin bir maliyeti yoktur.

curl çalışır ancak Cursor hala başarısız olur

Bu en kafa karıştırıcı durumdur ve birkaç yaygın açıklaması vardır.

Yanlış model seçildi. Cursor, kendi yerleşik modellerini listede tutar. Onlardan biri seçilirse, istek uç noktanıza hiç gitmez. Kullandığınız sohbet veya editör açılır menüsünde uncensored'i açıkça seçin.

Her özellik anahtarınızı kullanmaz. Satır içi otomatik tamamlama gibi Cursor'un kendi modellerine dayanan özellikler, eklediğiniz anahtara bakılmaksızın onları kullanmaya devam edebilir. Özel anahtarlar modelin seçilebildiği yerlerde, yani sohbet ve düzenleme modlarında geçerlidir. Bu sürümler arasında değiştiğinden Cursor'un güncel belgelerine bakın.

Ajan modundan kaynaklanan eşzamanlı istekler. Ajan ve çok adımlı çalıştırmalar aynı anda birden fazla istek tetikleyebilir. Deneme anahtarı aynı anda iki isteğe izin verir. Hatalar yalnızca ajan modunda görünüyorsa, büyük olasılıkla concurrency limitine takılıyorsunuzdur; tam anahtarla bu limit sekize çıkar. Akışlı bir istek, akış bitene kadar yuvasını tutar; bu nedenle uzun çıktılar yuvaları daha uzun süre meşgul eder.

Araç çağrıları. API, tool_calls akışlı ve sonuçlar role: "tool" olarak geçirilen araç çağırma desteği sunar. Araç kullanımı kalitesi modele bağlıdır, bu nedenle bir aracı çalıştırması bir araç adımında takılırsa, aynı görevi önce düz sohbette deneyin.

Hesap tarafını kontrol edin

curl bakiye hakkında bir hata döndürürse, anahtar geçerlidir ancak kredi boş veya deneme süresi dolmuştur. Deneme $0,50 değerindedir, 7 gün boyunca geçerlidir ve kayıt sonrası API anahtarı sayfasında tek tıkla talep edilir. Bundan sonra bir bakiye yüklemeniz gerekir.

Yüklemeler $20 ile $500 arasında herhangi bir tam miktardadır, $50'den +5%, $100'den +10% ve $200'den +15% ile. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz. Fiyatlandırma sayfası tabloyu gösterir. Henüz anahtarınız yoksa, buradan bir tane edinin.

Her araç için bir anahtar tutun. Bir anahtarı birden fazla editöre ve betiğe yapıştırdıysanız, hız limitleri bunlar arasında paylaşılır, bu da rastgele arızalar gibi görünebilir.

İnatçı bir durum için betik kontrolü

Hala nedeni bulamıyorsanız, editörün ne yaptığını yansıtan kısa bir betik çalıştırın. OpenAI SDK'sını kullanır, Cursor tarzı istemciler buna göre modellenmiştir ve tam hata nesnesini yazdırır.

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

Betik metin akışı yaparsa, uç nokta, anahtar ve model doğrudur ve kalan sorun bir Cursor ayarıdır. Bir durum kodu yazdırırsa yukarıdaki tabloyu kullanın. Destek ile iletişime geçerken X-Request-Id değerini koruyun, çünkü bu tam isteği tanımlar. Tam parametre ayrıntıları belgelendirme sayfasında yer almaktadır.

Tekrar bozulmasını önleyin

Tekrarlayan sorunların çoğunu önleyen birkaç alışkanlık vardır. Anahtarı tek bir parola yöneticisi girişinde saklayın ve oradan kopyalayın; sohbet günlüklerinden veya notlardan değil, çünkü orada satır sonları sızabilir. Editör güncellemesinden sonra bunları yeniden girebilmek için üç değeri (temel URL, anahtar, model adı) yazın; güncellemeler bazen geçersiz kılmaları sıfırlar. Her güncellemeden sonra gerçek işe başlamadan önce kısa bir sohbet mesajı gönderin.

Bakiyeyi izleyin. X-Balance-USD başlığı her yanıtta döndürülür ve ayrıca GET /v1/balance'den okuyabilirsiniz. Kredi hiç sona ermez, bu nedenle hesapta duran mütevazı bir yükleme boşa gitmez. Anahtarı editörün yanı sıra betiklerden de kullanıyorsanız, uzun toplu işlere 429 durumunda beş saniye bekleyen ve birkaç denemeden sonra duran bir yeniden deneme döngüsü sağlayın, böylece bir betik editörünüzün eşzamanlılık slotlarını aç bırakamaz.

10.000 token dosya bağlamı ve 700 tokenlik bir cevap ile bir kodlama sohbet isteği, giriş için 10.000 / 1.000.000 x $0,15 = $0,0015 ve çıktı için 700 / 1.000.000 x $0,50 = $0,00035 maliyetinde, toplamda yaklaşık $0,00185 eder. Oranlar 1M giriş token başına $0,15 ve 1M çıktı token başına $0,50'dir. Cursor API fiyatlandırması hakkındaki makale aylık tahminleri kapsar.

Başarısız olan istek büyükse, pencereyi hatırlayın: istem ve tamamlama 100.000 tokenin içine sığmalıdır ve istek gövdesi 8 MB ile sınırlıdır. Bir tüm kaynak kod deposunu sohbete eklemek her ikisini de aşabilir. Bağlamı önemli dosyalara indirgeyin ve tekrar deneyin.

01

Sorular ve cevaplar

Neden Cursor API anahtarımın geçersiz olduğunu söylüyor?

Genellikle anahtarın etrafında boşluk vardır veya kısmen kopyalanmıştır veya temel URL hala başka bir servise işaret etmektedir. Anahtarı yeniden kopyalayın, ardından geçersiz kılma URL'nin https://api.cursorapikey.com/v1 olduğundan emin olun.

Hangi model adını girmeliyim?

uncensored'ı küçük harfle girin. API'nin sunduğu tek model ID'si budur.

Otomatik tamamlama anahtarımı kullanıyor mu?

Her zaman değil. Bazı Cursor özellikleri Cursor'un kendi modellerini kullanır ve özel anahtarlar çoğunlukla modelin seçildiği sohbet ve düzenleme modlarında geçerlidir.

Başarısız istekler için ücretlendirilir misiniz?

Hayır. Başarısız veya reddedilen istekler için ücret alınmaz; bu nedenle hata ayıklama sırasında yeniden deneme yapmak ücretsizdir.

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.