Cursor için Codex API: Sansürsüz Modeli Bağlayın

Kurulumunuz

Cursor, özel model sağlayıcılarını destekleyen bir editördür. Size bir OpenAI tarzı base URL, bir anahtar ve bir model adı verdiğinizde, sohbet isteklerini varsayılan sağlayıcıya değil, bu adrese gönderir. Bu hizmet bu protokolü kullanır: POST /v1/chat/completions Bearer kimlik doğrulaması ile, ayrıca GET /v1/models.

Başlangıçta netleşmesi gereken iki şey. Bu, OpenAI'nin Codex'i veya Cursor'un resmi bir ürünü olmayan, tek bir açık ağırlıklı model çalıştıran bağımsız bir API'dir. Ve Cursor ayar ekranlarını sık sık değiştirir, bu nedenle aşağıdaki etiketler sürümünüzde biraz farklı bir yerde olabilir. Üç değer hiç değişmez: base URL, anahtar, model adı.

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

Google veya e-posta ve şifre ile API anahtarı sayfasında kaydolun. Yeni hesaplar tek tıkla $0,50 deneme kredisi alabilir; bu kredi 7 gün boyunca geçerlidir, kart gerekmez. Bu, bir editör kurulumunu test etmek için yeterlidir.

Cursor'a dokunmadan önce anahtarın çalıştığını doğrulayın. Editör içindeki bir hata, terminaldeki bir hatadan daha zor okunur.

Copycurl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

İçinde kod içeren bir JSON yanıtı alırsanız devam edin. Bir hata alırsanız önce buradan düzeltin. Yaygın nedenler anahtardaki eksik karakter veya sonuna yapıştırılmış bir boşluktur.

Adım 2: Cursor'u yapılandırın

1. Cursor'un ayarlarını açın ve modeller bölümüne gidin.
2. Bir OpenAI API anahtarı için alanı bulun ve anahtarınızı bu hizmetten yapıştırın.
3. OpenAI base URL'sini geçersiz kılma seçeneğini açın ve https://api.getcodexapi.com/v1 adresini girin.
4. Özel bir model ekleyin ve tam adını uncensored olarak yazın.
5. Varsa doğrula butonunu çalıştırın, ardından bir sohbet paneli açın ve model listesinden uncensored seçin.

Doğrulama adımı bir hata bildirirse, sırayla üç şeyi kontrol edin: base URL /v1 ile bitiyor ve ardından uç nokta yolu yok, anahtar sonuna boşluk olmadan yapıştırıldı ve model adında büyük harf yok. docs sayfasındaki rehber, aynı değerleri ek istemci örnekleriyle listeler.

Planlamanız gereken bir şey: geçersiz kılma bir ayardır, model başına bir seçim değildir, bu nedenle Cursor'da başka yerlerde kendi OpenAI anahtarınızı da kullanıyorsanız, önce geçersiz kılmayı kapatın. Ne değiştirdiğinizi not edin.

Kaydettikten sonra, sohbette basit bir kodlama sorusu sorun ve yanıtı izleyin. İlk yavaş yanıt, Cursor isteği oluştururken normaldir. Yanıt gelirse, bağlandınız ve bir sonraki adım kendi depolarınızda gerçek işlerde denemektir.

Anahtarınızdan hangi istekler geçer, hangileri geçmez

Cursor çeşitli özellikleri karıştırır. Sohbet ve satır içi düzenleme istekleri, özel modelinizi seçtikten sonra en çok onu kullanma ihtimali olanlardır. Diğer özellikler, örneğin tab tamamlama, tarihsel olarak Cursor'un kendi çalıştırdığı modelleri kullanmıştır ve ajan tarzı özellikler Cursor'un araçları nasıl ele aldığına bağlı olabilir. Güvenilir yol, güvendiğiniz özelliği denemek ve bakiyenizi izlemektir.

Bunu yapmak kolaydır: bu API'den her yanıt bir X-Balance-USD başlığı taşır ve bakiyeniz hesabınızda görünür. Bir sohbet mesajı gönderirseniz ve bakiye değişmezse, bu istek bize gitmedi.

Bu uç noktada fonksiyon çağırma desteklenir (tools, tool_choice, akışlı tool_calls ve sonuçlar role: "tool" olarak), editör ajanlarının ihtiyacı olan budur. Akış, stream: true ile sunucu tarafından gönderilen olaylar üzerinden çalışır. Bağlam penceresi 100.000 token'dır, istem ve tamamlama birlikte, bu nedenle büyük bir dosya ve komşuları tek bir istekte sığar.

Neden editörde sansürsüz model kullanılır

Çoğu kodlama işi bir reddiyeye maruz kalmaz. Olduğunda, genellikle dikkatli bir filtre için riskli görünen meşru görevler içindir: kendi ağınız için bir port tarayıcı yazmak, analiz ettiğiniz kötü amaçlı yazılım örneklerini ayrıştırmak, saldırgan dil içeren test verileri oluşturmak, yetişkinler için rol yapma veya arkadaş uygulamasının arka ucunu oluşturmak veya içerik moderasyonu ile ilgilenen kodu yeniden düzenlemek. Bu model, yasal yetişkin kullanımı için içerik reddiyeleri olmadan cevap verecek şekilde ayarlanmıştır.

Hala genel bir açık ağırlıklı modeldir, uzman bir kod modeli değil ve burada kod tabanınızda herhangi bir alternatifi geçeceğine dair bir vaat yoktur. Kendi görevlerinizi bunun üzerinden çalıştırın. Sabit bir kural var: reşit olmayanlar ile ilgili cinsel içerik yoktur ve bu değiştirilemez.

Pratikte maliyeti nedir

Fiyatlandırma, abonelik olmadan ön ödemeli krediden 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50'dir. Editör trafiği, her istek dosya bağlamını yeniden gönderdiği için girdi ağırlıklıdır.

8.000 girdi token ve 1.000 çıktı token içeren bir istek, girdi için 8.000 x $0,15 / 1.000.000 = $0,0012, çıktı için 1.000 x $0,50 / 1.000.000 = $0,0005 maliyetinde olur, bu da $0,0017 eder. Yoğun bir günde 150 tane yaparsanız, bu 150 x $0,0017 = $0,255, yaklaşık 26 senttir.

Bağlam olarak 40.000 token gönderen ve 1.500 token alan bir istek $0,006 + $0,00075 = $0,00675 tutarındadır. Yüklemeler $20'den başlar ve kredinin süresi hiç dolmaz, bu nedenle bakiyeyi bitirme baskısı yoktur. Bonus katmanları için fiyatlandırma sayfasına ve genel bakış için kodlama API sayfasına bakın.

Editör kullanımı için hız limitleri

Tam bir anahtar 8 eşzamanlı istek ve dakikada 300 istekle sınırlıdır. Bir deneme anahtarı 2 eşzamanlı ve dakikada 60 istekle sınırlıdır. Tek bir editörde yazan bir kişi nadiren bu limitlere yaklaşır, ancak tek bir anahtarı paylaşan bir ekip veya paralel olarak çok sayıda istek gönderen bir ajan buna yakınlaşabilir. Limiti aştığınızda API HTTP 429 döndürür. rate_limited kodu dakikada çok fazla istek anlamına gelir, concurrency ise aynı anda çok fazla istek anlamına gelir. Hizmet kısa süreli aşırı yüklenirse, Retry-After: 5 ile birlikte 429 hatası da alırsınız.

Akışlı bir sohbet, akış bitene kadar eşzamanlılık slotunu tutar. Paylaşımlı kullanım için, ekip için tek bir anahtar yerine her geliştiriciye kendi anahtarını verin.

Sorun giderme kontrol listesi

• Model bulunamadı. uncensored'i boşluk girmeden yeniden yazın. Kullanmadığınız eski özel modelleri kaldırın.
• Kimlik doğrulama hatası. Anahtarı yeniden kopyalayın. Cursor'un hala başka bir sağlayıcıdan anahtar kullanmadığından emin olun.
• Yanıtlar erken duruyor. Cursor'un kendi çıktı sınırını ayarlayıp ayarlamadığını kontrol edin. Bizim tarafımızda max_tokens isteğe bağlıdır.
• Bakiyenizde hiçbir şey değişmiyor. Kullandığınız özellik özel anahtarınız üzerinden yönlendirilmiyor. Bunun yerine sohbet deneyin.
• Sık 429. Eşzamanlı istekleri azaltın veya deneme anahtarı yerine tam anahtar kullanın.

Daha fazla kılavuz

• Codex API Fiyatlandırması: Token Başına Ödeme Oranları ve Örnekler
• Codex API Base URL: İstemcinizi Bizimkine Nasıl Yönlendirirsiniz
• Cursor için Sansürsüz LLM API