GitHub Copilot API Anahtarını Cursor API ile Kullanma

API Anahtarı Uyumluluğunu Anlamak

Geliştiriciler bir github copilot api anahtarıdan bahsettiklerinde, genellikle Microsoft GitHub ekosistemi içinde oluşturulan bir tokenı kastedler. Bu anahtar, GPT-4o veya kod için optimize edilmiş özel varyantlar gibi modelleri çalıştıran Microsoft sunucularına yapılan istekleri doğrular. Bu modeller güçlü olsa da, Microsoft hesabınızla ilişkili belirli içerik filtreleri ve hız limitleri getirir.

Buna karşılık, Cursor API bağımsız bir hizmet olarak çalışır. Microsoft altyapısına güvenmez. Bunun yerine, kodlama bağlamları için optimize edilmiş tek bir açık ağırlıklı büyük dil modelini sunar. Bu model, yasal yetişkin kullanımlarında içerik reddi olmadan yanıt verecek şekilde tasarlanmıştır ve standart filtreleri kısıtlayıcı bulan geliştiriciler için ayrı bir alternatiftir.

Bu ayrımı anlamak önemlidir. Mevcut GitHub Copilot API anahtarınız Cursor API uç noktasında çalışmaz. cursorapikey.com hesabınızdan ayrı bir anahtar oluşturmanız gerekir. Ancak temel protokol aynı kalır, bu da kodunuzun önemli ölçüde değişmemesi gerektiği anlamına gelir.

Ortamınızı Yapılandırma

Cursor API'yi kullanmak için önce bir anahtar oluşturmanız gerekir. Sadece bir e-posta ve şifre ile API anahtarı al sayfasında kaydolun. Başlangıç ücretsiz deneme kredisi için kredi kartı gerekmez. Kaydolduktan sonra anahtarınız hemen görüntülenir. Bu anahtarı ortam değişkenlerinizde, genellikle OPENAI_API_KEY veya ajanınızın gereksinimlerine bağlı olarak özel bir değişken olarak güvenli bir şekilde saklayın.

Cursor ve benzeri araçlar dahil çoğu kodlama aracı, OpenAI SDK standardına dayanır. Bu, özel bir kütüphaneye ihtiyacınız olmadığı anlamına gelir. SDK'nızı doğru temel URL'ye yönlendirmeniz yeterlidir. Cursor API için temel URL https://api.cursorapikey.com/v1 şeklindedir. Bu uç nokta, zaten aşina olduğunuz aynı istek yapılarını destekleyen tamamen OpenAI uyumludur.

Çevrenizin istekleri bu yeni temel URL'ye göndermek üzere yapılandırıldığından emin olun. İsteklerinizde belirtmeniz gereken model kimliği uncensored'dir. Bu, API'nin hangi belirli modeli çağıracağını belirtir. Bu model, GPT, Claude veya Gemini'den farklı olarak, kendi GPU sunucularımızda çalışan açık ağırlıklı bir modeldir.

Temel URL'leri Değiştirme

Bir github copilot api anahtarıdan Cursor API'ye geçiş, istemci yapılandırmanızdaki temel URL'yi değiştirmeyi içerir. Resmi OpenAI Python veya Node.js SDK'larını kullanıyorsanız, bu tek satırlık bir değişikliktir. Örneğin, Python'da istemciyi yeni temel URL ve yeni API anahtarınızla başlatırsınız.

Bu değişiklik, isteklerinizi Microsoft sunucularından bizim altyapımıza yönlendirir. Faydalar, 100.000 tokenlık bir bağlam penceresine erişim ve daha az reddiye için ayarlanmış bir model içerir. Bağlantıyı /v1/models uç noktasını kontrol ederek doğrulayabilirsiniz; bu uç nokta mevcut modelleri, uncensored dahil olmak üzere döndürmelidir.

Değiş tokuş: Sözdizimi aynı olsa da, Microsoft aboneliği üzerinden değil, token başına ödeme yapıyorsunuz. Fiyatlandırma şeffaftır: 1M giriş token'ı başına $0.25 ve 1M çıktı token'ı başına $1.00. Aylık ücret yoktur, sadece hiç bitmeyen kullandıkça öde kredisi vardır. Bu model, aylık oturma yeri maliyetine taahhüt etmek istemediğiniz değişken iş yükleri için idealdir.

Bağlantınızı Test Etme

API'yi ana iş akışınıza entegre etmeden önce, ortamınızın Cursor API ile iletişim kurabildiğini doğrulamak önemlidir. Bunu basit bir cURL komutu veya kısa bir betik ile yapabilirsiniz. Bu test, anahtarınızın geçerli olduğunu ve temel URL'nin doğru olduğunu sağlar.

Örnek cURL isteği:

Modeli uncensored olarak ayarlayarak https://api.cursorapikey.com/v1/chat/completions adresine POST isteği gönderin. Mesajlar dizisine basit bir istem ekleyin. Başarılı bir yanıt, choices[0].message.content alanında bir tamamlama döndürecektir.

401 hatası alırsanız API anahtarınız yanlıştır. 429 hatası alırsanız, anahtar başına dakikada 300 istek hız limitini aştınız demektir. Eski anahtarı geçersiz kılmak için anahtarınızı istediğiniz zaman yeniden oluşturabilirsiniz. Bu test, temel metin-giriş, metin-çıkış işlevselliğinin beklendiği gibi çalıştığını doğrular.

Akış Yanıtlarını Yönetme

Kodlama ajanları için akış yanıtları, pürüzsüz bir kullanıcı deneyimi sağlamak için kritiktir. Cursor API, akış için Server-Sent Events (SSE) destekler. Bu, tam yanıtı beklemek yerine tokenların oluşturuldukça alınmasını sağlar.

OpenAI SDK'sını kullanırken, stream parametresini true olarak ayarlayarak akışı etkinleştirebilirsiniz. SDK, veriler geldikçe veri parçalarını üretecektir. Bu, özellikle kullanıcıya ilerlemeyi göstermek veya token'ları canlı bir editöre beslemek istediğiniz uzun kod üretimi için özellikle yararlıdır.

Akışın, temel modeli veya yeteneklerini değiştirmediğini unutmayın. Bu tamamen bir teslim mekanizmasıdır. uncensored modeli, 100.000 tokenlık bağlam penceresine ve aynı fiyatlandırma yapısına bağlı kalmaya devam edecektir. Akış, modelin davranışını etkilemeden algılanan gecikmeyi iyileştiren bir istemci tarafı özelliğidir.

Araç Çağırma Entegrasyonu

Modern AI kodlama asistanları, kabuk komutlarını çalıştırma veya dosyalara erişme gibi dış dünyayla etkileşim kurmak için araç çağırma (fonksiyon çağırma) konusuna büyük ölçüde güvenir. Cursor API, bunu standart OpenAI uyumlu format aracılığıyla destekler.

İsteğinizde tools parametresini kullanarak araçlar tanımlayabilirsiniz. Model, bir aracın kullanılmasına karar verirse tool_calls dizisiyle yanıt verecektir. Uygulamanızın ardından aracı çalıştırması ve sonuçları bir sonraki mesajda API'ye göndermesi gerekir.

Bu işlem, bir github copilot api anahtarı ile Microsoft modellerini kullanma şeklinizle aynıdır. Buradaki avantaj tutarlılıktır. Araç çağırma için mevcut kodunuz varsa, minimum ayarlamalarla onu yeniden kullanabiliyor olmalısınız. Sadece araç tanımlarınızın uncensored modeli için beklenen şemaya uygun olduğundan emin olun.

Kullanım İzleme

Token başına ödeme yaptığınız için beklenmedik maliyetlerden kaçınmak amacıyla kullanımınızı izlemek önemlidir. Cursor API, kredi bakiyenizi ve kullanım geçmişinizi görüntüleyebileceğiniz bir panel sağlar. Kaç token tükettiğinizi ve ne kadar kredinin kaldığını görebilirsiniz.

Dikkat edilmesi gereken limitler:

• Hız limiti: Anahtar başına dakikada 300 istek.
• İstek gövdesi boyutu: İstek başına maksimum 8 MB.
• Bağlam penceresi: Toplam 100.000 token (giriş + çıkış).

Hız limitini aşarsanız 429 hatası alırsınız. Bu sınırlar içinde kaldığınızdan emin olmak için kullanımınızı gerçek zamanlı olarak izleyebilirsiniz. Ayrıca, anahtarınızın ele geçirildiğinden şüphelenirseniz API anahtarınızı yeniden oluşturabilirsiniz; bu, eski anahtarı hemen geçersiz kılar.

Yaygın Sorunların Giderilmesi

Güçlü bir API bile olsa sorunlar ortaya çıkabilir. İşte bazı yaygın sorunlar ve çözümleri.

401 Yetkisiz: API anahtarınızı kontrol edin. Doğru kopyalandığından ve başında veya sonunda boşluk olmadığından emin olun. Anahtarınızı yeniden oluşturduysanız, yeni olanı kullandığınızdan emin olun.

429 Çok Fazla İstek: Dakikada 300 istek limitini aştınız. İstemcinizde üstel geri çekilme (exponential backoff) uygulayın veya istek sıklığınızı azaltın.

400 Geçersiz İstek: Bu genellikle hatalı bir JSON yükü veya eksik gerekli alanlar gösterir. messages dizinizin doğru biçimlendirildiğinden ve role ile content alanlarını içerdiğinden emin olun. Ayrıca model adının tam olarak uncensored olduğunu doğrulayın.

İçerik Engelleme: Model sansürsüz olsa da, çocukların cinsel istismarını engeller. İsteğiniz engellenirse, bunun nedeni bu belirli katı sınırlamadan kaynaklanıyor olabilir.