cursorapikey.com/Rehber
Özel uç nokta ile Cursor API anahtarlarını nasıl kullanılır
Kendi uç noktanızla Cursor API ayarlarını kullanma: bir anahtar yapıştırın, OpenAI base URL'ini geçersiz kılın ve uncensored model adını ekleyin. Aşağıdaki adımlar yaklaşık beş dakika sürer ve önce çalıştırabileceğiniz bir curl kontrolü içerir.
güncellendi

Temel noktalar
- Cursor, OpenAI base URL'ini ve anahtarını geçersiz kılmanıza olanak tanır, böylece herhangi bir OpenAI uyumlu uç nokta istekleri işleyebilir.
- Base URL https://api.cursorapikey.com/v1 ve model ID
uncensoredkullanın. - Editöre dokunmadan önce anahtarı curl ile test edin, böylece hatanın hangi taraftan geldiğini bilirsiniz.
- 20.000 token'lık bir istem ve 1.000 token'lık bir yanıt $0,0035 tutarındadır.
Bu rehber neleri kapsar
Cursor API nasıl kullanılır diye arama yapanlar genellikle iki şeyden birini kastediyordur. Ya kodunuzdan bazı Cursor hizmetlerini çağırmak istiyorlar ya da Cursor editörünün model isteklerini seçtikleri bir uç noktaya göndermesini istiyorlar. Bu rehber ikinci durum içindir. Bu site, OpenAI sohbet tamamlama protokolünü konuşan bağımsız bir barındırılmış API'dir, bu nedenle Cursor ona, herhangi bir OpenAI tarzı sunucuyla konuştuğu şekilde konuşabilir.
Arkadaki model, bağımsız bir sağlayıcı tarafından yürütülen ve yetişkinlerin yasal kullanımı için içerik reddi olmadan cevap verecek şekilde ayarlanmış tek bir açık ağırlıklı modeldir. Resmi bir Cursor modeli değildir ve tedarikçiler arasında bir yönlendirici değildir. Sadece metin işler. Kodlama için bu genellikle yeterlidir: kod ve talimatları gönderirsiniz, kod ve açıklamalar alırsınız.
Üç şeye ihtiyacınız var: bir API anahtarı, base URL https://api.cursorapikey.com/v1 ve model ID uncensored. Geri kalanı editördeki doğru alanları bulma meselesidir.
Adım 1: bir anahtar alın ve curl ile kontrol edin
Google veya e-posta ve şifre ile kaydolun, ardından API anahtarı sayfasını açın. Yeni hesaplar, tek tıkla orada $0,50 deneme kredisi talep edebilir. Karta gerek yoktur ve 7 gün boyunca geçerlidir. Deneme anahtarı 2 eşzamanlı istek ve dakikada 60 istek ile sınırlıdır, bu editördeki ilk oturum için yeterlidir.
Cursor'u açmadan önce anahtarın çalıştığını onaylayın. Anahtarınızı bir ortam değişkeninde kullanarak terminalde bunu çalıştırın:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
İlk çağrı modeli listeler. İkincisi normal bir sohbet tamamlaması döndürür. İkisi de başarılı olursa, editördeki sonraki tüm hatalar bir ayar sorunudur ve anahtar sorunu değildir. Bu ayrım çok fazla tahmin yapmaktan kurtarır.
Adım 2: Cursor'da base URL ve anahtarı ayarlayın
Cursor ayarlarını açın ve modeller bölümüne gidin. Menü adları ve düzen sürümler arasında değişir, bu nedenle aşağıdaki etiketleri bir harita olarak kabul edin ve bir şeyler yer değiştirdiyse Cursor'un kendi belgelerine bakın.
- Bir OpenAI API anahtarı için alanı bulun ve anahtarınızı bu siteden yapıştırın.
- OpenAI base URL'ini geçersiz kılma seçeneğini etkinleştirin ve
https://api.cursorapikey.com/v1girin. Sonunda/v1bırakın ve/chat/completionseklemeyin; istemci uygulaması yolu kendisi ekler. - Özel bir model ekleyin ve tam olarak küçük harfle
uncensoredyazın. - Editör bir doğrula veya kaydet düğmesi sunarsa bunu kullanın, ardından sohbet panelinde yeni modeli seçin.
Açık bir dosya ile "bu fonksiyonu açıkla" gibi kısa bir mesaj gönderin. Akışlı bir yanıt, rotanın uçtan uca çalıştığını gösterir. Cursor isteği gönderir, uç nokta tokenları SSE üzerinden akış olarak gönderir ve editör bunları geldikçe görüntüler.
İki uyarı. Bazı editör özellikleri, örneğin satır içi tamamlama, Cursor'un kontrol ettiği modellerde çalışabilir ve anahtarınızı yok sayabilir, bu nedenle hangi özelliklerin gerçekten özel modeli kullandığını kontrol edin. Ve Cursor özel anahtar trafiğini kendi sunucuları üzerinden yönlendirebileceğinden, kodunuzun tam olarak nereye gittiğini bilmek istiyorsanız mevcut belgelerine bakın. Bu sitedeki hızlı başlangıç API tarafındaki sözleşmeyi listeler.
Aynı uç noktayı koddan test edin
Bir sorunu izole etmenin en kolay yolu, uç noktayı resmi OpenAI SDK ile çağırmaktır. Eğer bu çalışırsa, uç nokta iyidir ve kalan sorun editör yapılandırmasındadır.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Node'da aynı şey:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
Akışlı yanıtlar, bir isteğin kaç token kullandığını tam olarak günlüğe kaydedebilmeniz için sonunda kullanım verisini içerir. Her yanıt ayrıca kalan kredinizi gösteren X-Balance-USD başlığını ve bir şeyler yanlış görünürse referans alabileceğiniz X-Request-Id taşır.
Kodlama iş akışında ne çalışır
API, akış, JSON modu ve fonksiyon çağırma (tools, tool_choice, akışlı tool_calls ve role: "tool" olarak gönderilen sonuçlar) destekler. temperature, top_p, stop, seed gibi örnekleme ayarları ve cezalar iletilir. Bağlam penceresi 100.000 token olup, istem ve tamamlama arasında paylaşılır; max_tokens isteğe bağlıdır.
Bu 100.000 token kod için cömert bir bütçedir. Yüzlerce satırlık bir kaynak dosya birkaç bin token demektir, bu nedenle birkaç dosyayı uzun bir talimatla birlikte ekleyebilir ve hala yanıt için yer bırakabilirsiniz. Maksimum istek gövdesi 8 MB'tır, bu metinle ulaşmayacağınız bir değerdir.
Editörde özel modeli hoş bir hale getiren bazı alışkanlıklar:
- Kod düzenlemeleri için düşük bir
temperaturetutun. 0,2 civarı değerler daha istikrarlı çıktı verir; sadece beyin fırtınası için yükseltin. - Sadece önemli dosyaları ekleyin. Gönderdiğiniz her token girdi olarak faturalandırılır ve her adımda tüm konuşma yeniden gönderilir.
- Dosya uzun olduğunda tüm dosyayı değil, farkları veya değiştirilen fonksiyonu isteyin. Çıktı tokenları, girdi tokenlarından daha pahalıdır.
- Modeli, kendi laboratuvarınız için istismar kanıtları yazma, incelemesine yetkili olduğunuz kötü amaçlı yazılım örneklerini analiz etme veya kaba gerçek dünya içeriğini taklit eden test verisi oluşturma gibi reddedilmelerin engel olduğu görevler için kullanın. Tüm bunlar yasal olmalıdır.
Tekrar etmeye değer olan tek zor sınır: herhangi bir bağlamda reşit olmayanları içeren hiçbir cinsel içeriğe izin verilmez.
Yaygın hataları düzeltme
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 veya "geçersiz anahtar" | Anahtarın boşlukla yapıştırılması veya eski bir anahtar | Anahtar sayfasından tekrar kopyalayın; curl ile test edin |
| 404 veya "model bulunamadı" | Model adı farklı yazılmış | uncensored modelini, küçük harfle ve sonek olmadan kullanın |
| Yolda 404 | Base URL /chat/completions içerir | Base URL'yi /v1 ile bitirin |
concurrency ile 429 | Aynı anda çok fazla istek | Akışların bitmesini bekleyin; tam anahtar 8, deneme anahtarı 2 izin verir |
rate_limited ile 429 | Dakikada 300'den fazla istek (denemede 60) | Yavaşlayın veya bir bekleme süresinden sonra yeniden deneyin |
429 ile Retry-After: 5 | Geçici aşırı yüklenme | Beş saniye sonra tekrar deneyin |
Akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar. Cursor'da birkaç sohbet başlatır ve oluşturmayı bırakırsanız, deneme anahtarında eşzamanlılık sınırına hızla ulaşabilirsiniz. Başarısız veya reddedilen istekler faturalandırılmaz, bu nedenle yeniden denemek ek maliyet gerektirmez.
Bir kodlama oturumu neye mal olur
Fiyatlandırma 1M girdi token başı $0,15 ve 1M çıktı token başı $0,50'dir; ön ödemeli krediden, abonelik olmadan ödenir. Tipik bir düzenleyici isteği büyük bir istem (dosyalarınız) ve kısa bir yanıttan oluşur. 20.000 girdi token ve 1.000 çıktı token alalım:
- Girdi: 20.000 x $0,15 / 1.000.000 = $0,0030
- Çıktı: 1.000 x $0,50 / 1.000.000 = $0,0005
- Toplam: istek başına $0,0035
Çalışma gününde 100 istek bu $0,35 eder. $0,50 deneme kredisi yaklaşık 140 böyle isteği karşılar. Deneme süresinden sonra $20 ile $500 arasında herhangi bir tam tutarı yükleyebilir, $50'den +5%, $100'den +10% ve $200'den +15% bonus kredi alabilirsiniz. Kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapın. Kredi hiç sona ermez, bu yüzden yavaş kullandığınız bir bakiye yükleme boşa gitmez. fiyatlandırma sayfası tam tabloyu içerir ve Cursor ve Copilot alternatifi sayfası bunun abonelikli editörlerin yanında nereye oturduğunu açıklar.
İstemler eğitim için kullanılmaz.
Daha fazla kılavuz
Sorular ve cevaplar
Bu, Cursor agent ve fonksiyon çağırma ile çalışır mı?
API, araçlar, tool_choice ve akışlı tool_calls ile fonksiyon çağırma desteği sunar. Belirli bir Cursor özelliğinin özel modelinizi kullanıp kullanmadığı editöre bağlıdır; kurulumdan sonra her özelliği test edin.
Hangi model adını girmeliyim?
Küçük harfle uncensored girin. Bu tek model ID'sidir ve GET /v1/models bunu listeler.
Bu resmi Cursor API mi?
Hayır. Bu, tek bir açık ağırlıklı modelin önünde bağımsız bir OpenAI uyumlu API'dir. Cursor, OpenAI ayarlarınızı farklı bir uç noktaya yönlendirmenize olanak tanır.
Denemek için bir kart gerekiyor mu?
Hayır. $0,50 deneme kredisi, kayıt sonrası API anahtarı sayfasında tek tıkla alınır; kart gerekmez ve 7 gün boyunca geçerlidir.
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.