cursorapikey.com/Dokumentacja
Szybki start dla użytkowników Cursora
Podłącz narzędzia do kodowania do API bez cenzury, aktualizując bazowy URL i nagłówki uwierzytelniające. Ten szybki start obejmuje podstawowe konfiguracje dla Cursora i innych agentów kompatybilnych z OpenAI.
Bazowy URL i uwierzytelnianie
Skonfiguruj klienta, aby wskazywał na https://api.cursorapikey.com/v1. Usługa oczekuje standardowych nagłówków uwierzytelniania OpenAI. Wygeneruj klucz na stronie Pobierz klucz API; będzie Ci potrzebny do każdego zapytania. Użyj identyfikatora modelu uncensored, aby uzyskać dostęp do jedynego dostępnego modelu. Ta konfiguracja działa z dowolnym SDK lub agentem kompatybilnym z OpenAI, np. Cursor, Claude Code lub niestandardowymi endpointami GitHub Copilot.
Pierwsze zapytanie
Przetestuj łączność prostym uzupełnieniem czatu. Endpoint obsługuje standardowe ciała zapytań. Jeśli otrzymasz status 200, Twoja konfiguracja jest poprawna. Błąd 401 oznacza nieprawidłowy lub brakujący klucz, a błąd 402 oznacza, że Twój przedpłacony kredyt został wyczerpany.
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."}]
}'
Zapytania przekraczające 8 MB lub 300 zapytań na minutę mogą zwracać konkretne kody błędów. Sprawdź sekcję limitu zapytań, aby uzyskać szczegółowe informacje.
Integracja z Python SDK
Użyj oficjalnej biblioteki Pythona OpenAI. Ustaw podstawowy adres URL i klucz API podczas inicjalizacji klienta. Identyfikator modelu pozostaje uncensored. To podejście działa dla skryptów lokalnych lub integracji agentów wymagających programistycznego dostępu do API. Upewnij się, że wersja Twojej biblioteki obsługuje wymagane struktury API OpenAI.
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)
Pamiętaj, że prompty nie są używane do trenowania. Kontekst Twojego kodu pozostaje prywatny w ramach zapytania.
Integracja z Node SDK
Zainicjuj klienta OpenAI Node.js z niestandardowym adresem URL bazowym. Przekaż klucz API ze zmiennych środowiskowych. ID modelu uncensored jest wymagane we wszystkich uzupełnieniach. To rozwiązanie jest idealne dla agentów opartych na Node.js lub funkcji serverless wymagających spójnej pomocy AI.
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);
Zweryfikuj swoje dane uwierzytelniające przed wykonaniem żądań zbiorowych, aby uniknąć niepotrzebnych błędów 402.
Odpowiedzi strumieniowe
Włącz strumieniowanie, ustawiając stream: true w ciele żądania. API zwraca zdarzenia wysłane przez serwer (SSE). Pozwala to Twojemu interfejsowi lub agentowi przetwarzać tokeny w miarę ich generowania. Strumieniowanie zmniejsza postrzegane opóźnienie przy dużych odpowiedziach. Upewnij się, że Twój klient poprawnie obsługuje częściowe fragmenty.
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)
Każdy fragment zawiera treść częściową. Połącz je, aby utworzyć ostateczną odpowiedź.
Limity, błędy i okno kontekstu
Okno kontekstu wynosi 100 000 tokenów dla promptu i uzupełnienia łącznie. Limity zapytań to 300 zapytań na minutę na klucz. Jeśli wygenerujesz klucz ponownie, stary klucz jest natychmiast unieważniony. Błąd 401 oznacza nieprawidłowy klucz. Błąd 402 oznacza niewystarczający kredyt. Błąd 429 oznacza przekroczenie limitu zapytań. Kredyt nigdy nie wygasa. Opcje doładowania obejmują kryptowaluty (USDT lub USDC).
Parametry API
Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.
| Element | Wartość |
|---|---|
| Format API | zgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz |
| ID modelu | uncensored |
| Uwierzytelnianie | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.cursorapikey.com/v1 |
| Endpointy | POST /v1/chat/completions · GET /v1/models |
| Parametry | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Tryb JSON | response_format: {"type": "json_object"} |
| Maks. odpowiedź | do reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu) |
| Okno kontekstu | 100 000 tokenów (wejście + odpowiedź) |
| Wywoływanie funkcji | tak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool |
| Strumieniowanie | tak — server-sent events; ostatni fragment zawiera zużycie tokenów |
| Rozmiar zapytania | do 8 MB |
| Równoległe zapytania | do 8 jednocześnie na klucz |
| Limit zapytań | 300 zapytań na minutę na klucz |
| Nagłówki odpowiedzi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Cena | $0,25 za 1 mln tokenów wejścia · $1,00 za 1 mln tokenów wyjścia |
| Darmowy kredyt | $0,50 na 7 dni, bez karty · Klucz próbny: 2 równoległe żądania, 60 na minutę; pełne limity (8 i 300) po pierwszym doładowaniu |
| Bonus | +5% od $50, +10% od $100 |
| Ważność | opłacony kredyt nie wygasa, bez subskrypcji |
| Doładowanie | USDT (TRC20) lub USDC (Base), dowolna pełna kwota od $10 do $500 |
| Rozliczenie | przedpłacony kredyt według rzeczywistego zużycia; błędy i odmowy są darmowe |
| Logowanie | Google albo e-mail i hasło |
| Klucze | jeden aktywny klucz na konto; nowy zastępuje stary |
| Treści | treści dla dorosłych dozwolone; treści seksualne z udziałem nieletnich są odrzucane |
Kody błędów
Błędy wracają jako JSON ze stałym type; nieudane i odrzucone zapytania są bezpłatne.
| Kod | Typ | Znaczenie |
|---|---|---|
400 | bad_request | błędny JSON, puste wiadomości, zły parametr lub za długi kontekst |
401 | missing_key · invalid_key · key_revoked | brak klucza, zły klucz lub klucz zastąpiony nowym |
402 | no_credit | brak kredytu — doładuj, działa od razu |
403 | content_blocked | treści seksualne z nieletnimi — odmowa, bez opłaty |
404 | not_found | nieznany endpoint |
413 | request_too_large | treść większa niż 8 MB |
429 | rate_limited · concurrency | ponad 300/min lub 8 równolegle — odczekaj i ponów |
503 | upstream_busy | model zajęty — ponów za kilka sekund |
Pytania i odpowiedzi
Czy to oficjalne API Cursora?
Nie, jest to niezależna usługa. Jest kompatybilna z OpenAI i działa jako niestandardowy endpoint w Cursorze i podobnych narzędziach. Nie jest powiązana z Cursor, OpenAI ani Anthropic.
Co się stanie, jeśli przekroczę limit zapytań?
Zapytania przekraczające 300 na minutę zwrócą błąd 429. Limit dotyczy każdego klucza. Wygenerowanie klucza ponownie unieważnia stary klucz, ale nie resetuje okna limitu zapytań dla nowego klucza.
Jak doładować moje konto?
Możesz doładować od $10 używając kryptowalut (USDT lub USDC). Dostępny jest kredyt bonusowy: +5% od $50 i +10% od $100. Płacony kredyt nigdy nie wygasa.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.