cursorapikey.com/Dokümanlar
Cursor kullanıcıları için hızlı başlangıç
Kodlama araçlarınızı sansürsüz API'ye bağlamak için temel URL'yi ve kimlik doğrulama başlıklarını güncelleyin. Bu hızlı başlangıç, Cursor ve diğer OpenAI uyumlu ajanlar için temel yapılandırmaları kapsar.
Temel URL ve Kimlik Doğrulama
İstemcinizi https://api.cursorapikey.com/v1 adresine yönlendirecek şekilde yapılandırın. Hizmet standart OpenAI kimlik doğrulama başlıklarını bekler. API anahtarını al sayfasından anahtarınızı oluşturun; her istek için buna ihtiyacınız olacak. Tek mevcut modele erişmek için uncensored model kimliğini kullanın. Bu kurulum, Cursor, Claude Code veya GitHub Copilot özel uç noktaları gibi herhangi bir OpenAI uyumlu SDK veya ajan ile çalışır.
İlk İstek
Basit bir sohbet tamamlama isteğiyle bağlantıyı test edin. Uç nokta standart istek gövdelerini destekler. 200 durum kodu alırsanız yapılandırmanız doğrudur. 401 hatası geçersiz veya eksik bir anahtarı, 402 hatası ise ön ödemeli kredinizin tükendiğini gösterir.
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 blunt product review of a cheap VPN."}]
}'
8 MB'ı aşan istekler veya dakikada 300 isteği belirli hata kodları döndürebilir. Ayrıntılar için hız limiti bölümüne bakın.
Python SDK Entegrasyonu
Resmi OpenAI Python kütüphanesini kullanın. İstemci başlatmasında temel URL'yi ve API anahtarını ayarlayın. Model kimliği uncensored olarak kalır. Bu yaklaşım, programatik API erişimi gerektiren yerel betikler veya ajan entegrasyonları için çalışır. Kütüphane sürümünüzün gerekli OpenAI API yapılarını desteklediğinden emin olun.
from openai import OpenAI
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
İstemlerin eğitim için kullanılmadığını unutmayın. Kod bağlamınız isteğe özel kalır.
Node SDK Entegrasyonu
Özel temel URL ile OpenAI Node.js istemcisini başlatın. API anahtarını ortam değişkenlerinden iletin. Tüm tamamlamalar için uncensored model kimliği gereklidir. Bu kurulum, tutarlı AI desteği gerektiren Node tabanlı ajanlar veya sunucusuz işlevler için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cursorapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Gereksiz 402 hatalarından kaçınmak için toplu istekler yapmadan önce kimlik bilgilerinizi doğrulayın.
Akış Yanıtları
İstek gövdenizde stream: true ayarlayarak akışı etkinleştirin. API, Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Bu, UI'nizin veya ajanınızın tokenları oluşturulurken işlemesine olanak tanır. Akış, büyük yanıtlar için algılanan gecikmeyi azaltır. İstemcinizin kısmi parçaları doğru şekilde işlediğinden emin olun.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Her parça kısmi içerik içerir. Son yanıtı oluşturmak için bunları birleştirin.
Sınırlar, Hatalar ve Bağlam
Bağlam penceresi, istem ve tamamlama birlikte 100,000 token'dır. Hız limitleri anahtar başına dakikada 300 istektir. Anahtarınızı yenilerseniz, eski anahtar hemen iptal edilir. 401 hatası geçersiz bir anahtarı gösterir. 402 hatası yetersiz krediyi gösterir. 429 hatası hız limitinin aşıldığını gösterir. Kredi süresi dolmaz. Bakiye yükleme seçenekleri arasında kripto para (USDT veya USDC) yer alır.
API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.cursorapikey.com/v1 |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON modu | response_format: {"type": "json_object"} |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Giriş | Google veya e-posta ve şifre |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bu resmi Cursor API'si mi?
Hayır, bu bağımsız bir hizmettir. OpenAI uyumludur ve Cursor ve benzeri araçlarda özel bir uç nokta olarak çalışır. Cursor, OpenAI veya Anthropic ile bağlantılı değildir.
Hız limitini aşarsam ne olur?
Dakikada 300 isteği aşan istekler 429 hatası döndürür. Limit anahtar başına geçerlidir. Anahtarınızı yenilemek eskisini iptal eder ancak yeni anahtar için hız limiti penceresini sıfırlamaz.
Hesabımı nasıl yüklerim?
Kripto para (USDT veya USDC) kullanarak en az $10 ile bakiye yükleyebilirsiniz. Bonus kredi mevcuttur: $50'den +%5 ve $100'den +%10. Ödemeli kredi süresi asla dolmaz.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulum bu kadar.