Cursor ile Kullanım (Kendi Anahtarınızla)

Cursor'da Onysoft modellerini OpenAI uyumlu adresle kullanın

Cursor'ın "Override OpenAI Base URL" ayarıyla Onysoft kataloğundaki modelleri Cursor içinde kullanabilirsiniz. İstekler /v1/chat/completions ucuna gelir ve Onysoft bakiyenizden ücretlendirilir.

Kurulum

1. Kendi API anahtarınızla özel model kullanmak için Cursor'ın ücretli planı (Pro ya da üstü) gerekir; ücretsiz planda yalnız Cursor'ın "Auto" kipi açıktır.
2. Panelde API Anahtarları sayfasından Cursor için ayrı bir anahtar oluşturun.
3. Cursor → Settings → Models → API Keys bölümünde "OpenAI API Key" alanına sk-ony- anahtarınızı yapıştırın.
4. "Override OpenAI Base URL" seçeneğini açıp https://api.onysoft.com/v1 yazın; sonuna /chat/completions eklemeyin.
5. "Add Custom Model" ile modelin katalog kimliğini tam olarak girin (ör. deepseek/deepseek-v4.1-flash, openai/gpt-5.3-codex, anthropic/claude-sonnet-5.5) ve Verify ile doğrulayın. Kimlik listesi: Modeller sayfası ya da GET /v1/models.
6. Sohbet penceresindeki model seçicide Auto'yu kapatıp eklediğiniz modeli seçin.

Ask ve Agent Kipleri

Ask (sohbet) kipi standart sohbet istekleri gönderir. Agent kipinde Cursor, GPT ve Claude adlı modellerde farklı istek biçimleri (Responses gövdesi, ApplyPatch aracı) gönderir; bu biçimler 4 Kasım 2026'dan beri sunucu tarafında destekleniyor. Agent kipi 6 Kasım 2026'da gerçek Cursor istemcisiyle test edildi; sorun görürseniz kullandığınız modeli ve hata metnini destek üzerinden bize iletin.

Bağlantı Sorunları

Bağlantı hatası görürseniz Settings → Network → HTTP Compatibility Mode ayarını HTTP/1.1 yapın, Base URL'nin https://api.onysoft.com/v1 olduğunu ve model kimliğini büyük/küçük harf ve eğik çizgi dahil aynen yazdığınızı kontrol edin.

Cursor Tarafındaki Kısıtlar

• Tab otomatik tamamlama her zaman Cursor'ın kendi modelini kullanır.
• Bu ayar açıkken görsel ekleme çalışmaz (Cursor hatası); görsel içeren işler için ayarı kapatıp Cursor'ın kendi modellerini kullanın.
• "Override OpenAI Base URL" açıkken Cursor'ın kendi OpenAI modelleri de bu adrese yönlenir ve "model not available" hatası verir; Cursor'ın modellerini kullanacağınız zaman ayarı kapatın.
• Cursor'ın kendi model adlarıyla aynı adlı özel model eklenemez; önekli katalog kimliklerini kullanın.
• Cursor bu yolda tüm istekleri kendi sunucularından geçirir; kendi anahtarınızla yapılan isteklerde Cursor'ın sıfır saklama politikası geçerli değildir (KVKK değerlendirmenize ekleyin).
• Cursor Teams/Enterprise planlarında Cursor, kendi anahtarla yapılan isteklerden de ücret alabilir.

Bakiye ve Hız Sınırı

Cursor isteklerde azami çıktı sınırı göndermez; bakiye ön kontrolü modelin azami çıktısına göre yapılır, bu yüzden düşük bakiyede istekler "yetersiz bakiye" ile reddedilebilir. Ücret gerçek kullanımdan kesilir. Dakikada 60'tan fazla istekte Cursor "User API Key Rate limit exceeded" gösterir; Cursor için ayrı bir anahtar kullanmak bunu hafifletir.