Jak używać klucza API GitHub Copilot z API Cursor

Zrozumienie kompatybilności kluczy API

Gdy programiści mówią o kluczu API github copilot, zazwyczaj mają na myśli token wygenerowany w ekosystemie Microsoft GitHub. Klucz ten uwierzytelnia żądania do serwerów Microsoftu, które uruchamiają modele takie jak GPT-4o lub specjalne warianty zoptymalizowane pod kątem kodu. Choć te modele są potężne, mają określone filtry treści i limity zapytań powiązane z Twoim kontem Microsoftu.

W przeciwieństwie do tego API Cursor działa jako niezależna usługa. Nie opiera się na infrastrukturze Microsoftu. Zamiast tego obsługuje pojedynczy model LLM o otwartych wagach zoptymalizowany pod kątem kontekstów programistycznych. Model ten został zaprojektowany tak, aby odpowiadać bez odrzucania treści przy prawnym użyciu dla dorosłych, co czyni go odrębną alternatywą dla programistów, którzy uznają standardowe filtry za restrykcyjne.

Zrozumienie tej różnicy jest kluczowe. Twój istniejący klucz API GitHub Copilot nie zadziała z endpointem API Cursor. Potrzebujesz osobnego klucza wygenerowanego na swoim koncie na cursorapikey.com. Jednak podstawowy protokół pozostaje taki sam, co oznacza, że Twój kod nie musi ulec znaczącej zmianie.

Konfiguracja środowiska

Aby korzystać z API Cursor, musisz najpierw wygenerować klucz. Zarejestruj się na stronie Pobierz klucz API podając tylko adres e-mail i hasło. Nie jest potrzebna karta kredytowa do początkowego kredytu próbnego. Po rejestracji Twój klucz jest wyświetlany natychmiast. Przechowuj ten klucz bezpiecznie w zmiennych środowiskowych, zwykle jako OPENAI_API_KEY lub niestandardową zmienną w zależności od wymagań Twojego agenta.

Większość agentów kodujących, w tym Cursor i podobne narzędzia, opiera się na standardzie SDK OpenAI. Oznacza to, że nie potrzebujesz niestandardowej biblioteki. Po prostu musisz wskazać swoje SDK na właściwy bazowy URL. Bazowy URL dla API Cursor to https://api.cursorapikey.com/v1. Ten endpoint jest w pełni kompatybilny z OpenAI, obsługując te same struktury zapytań, z którymi jesteś już zaznajomiony.

Upewnij się, że Twoje środowisko jest skonfigurowane do wysyłania żądań pod ten nowy bazowy URL. ID modelu, który musisz określić w swoich żądaniach, to uncensored. Informuje to API, który konkretny model ma wywołać. Jest to model o otwartych wagach uruchamiany na naszych własnych serwerach GPU, distinct od GPT, Claude lub Gemini.

Zmiana bazowych URL

Przełączenie się z klucza API github copilot na API Cursor wiąże się głównie ze zmianą bazowego URL w konfiguracji klienta. Jeśli używasz oficjalnych SDK Python lub Node.js OpenAI, jest to zmiana jednej linii. Na przykład w Pythonie zainicjujesz klienta z nowym bazowym URL i swoim nowym kluczem API.

Ta zmiana przekierowuje Twoje żądania z serwerów Microsoftu do naszej infrastruktury. Korzyści obejmują dostęp do 100 000 okna kontekstu tokenów i modelu dostrojonego do mniejszej liczby odrzuceń. Możesz zweryfikować połączenie, sprawdzając endpoint /v1/models, który powinien zwracać dostępne modele, w tym uncensored.

Kompromis: Choć składnia jest identyczna, płacisz teraz za token, a nie poprzez subskrypcję Microsoftu. Nasze ceny są przejrzyste: $0,25 za 1M tokenów wejściowych i $1,00 za 1M tokenów wyjściowych. Nie ma opłat miesięcznych, tylko kredyt do doładowania, który nigdy nie wygasa. Model ten jest idealny dla zmiennych obciążeń, gdzie nie chcesz angażować się w miesięczny koszt miejsca.

Testowanie połączenia

Przed zintegrowaniem API ze swoim głównym przepływem pracy, istotne jest zweryfikowanie, czy Twoje środowisko może komunikować się z API Cursor. Możesz to zrobić za pomocą prostego polecenia cURL lub krótkiego skryptu. Test ten zapewnia, że Twój klucz jest ważny, a bazowy URL jest poprawny.

Przykładowe żądanie cURL:

Wyślij żądanie POST do https://api.cursorapikey.com/v1/chat/completions z modelem ustawionym na uncensored. Dołącz prosty prompt w tablicy messages. Pomyślna odpowiedź zwróci uzupełnienie w polu choices[0].message.content.

Jeśli otrzymasz błąd 401, Twój klucz API jest nieprawidłowy. Jeśli otrzymasz błąd 429, przekroczyłeś limit zapytań wynoszący 300 zapytań na minutę na klucz. Możesz wygenerować ponownie swój klucz w dowolnym momencie, aby unieważnić stary. Ten test potwierdza, że podstawowa funkcjonalność tekst-wejście, tekst-wyjście działa zgodnie z oczekiwaniami.

Obsługa odpowiedzi strumieniowych

Dla agentów kodujących odpowiedzi strumieniowe są kluczowe dla zapewnienia płynnego doświadczenia użytkownika. API Cursor obsługuje zdarzenia wysłane przez serwer (SSE) do strumieniowania. Pozwala to na otrzymywanie tokenów w miarę ich generowania, zamiast czekania na pełną odpowiedź.

Podczas używania SDK OpenAI możesz włączyć strumieniowanie, ustawiając parametr stream na true. SDK będzie zwracać fragmenty danych, gdy nadejdą. Jest to szczególnie przydatne przy długich generacjach kodu, gdzie chcesz wyświetlać postęp użytkownikowi lub przekazywać tokeny do edytora na żywo.

Pamiętaj, że strumieniowanie nie zmienia podstawowego modelu ani jego możliwości. Jest to czysty mechanizm dostarczania. Model uncensored nadal będzie przestrzegał 100 000 okna kontekstu tokenów i tej samej struktury cenowej. Strumieniowanie to funkcja po stronie klienta, która poprawia postrzeganą opóźnienie bez wpływu na zachowanie modelu.

Integracja wywoływania narzędzi

Nowoczesne asystenty AI do kodowania silnie polegają na wywoływaniu narzędzi (wywoływanie funkcji) do interakcji ze światem zewnętrznym, takim jak uruchamianie poleceń powłoki lub dostęp do plików. API Cursor obsługuje to poprzez standardowy format kompatybilny z OpenAI.

Możesz zdefiniować narzędzia w swoim żądaniu za pomocą parametru tools. Model odpowie tablicą tool_calls, jeśli uzna, że narzędzie powinno zostać użyte. Twoja aplikacja musi następnie wykonać narzędzie i przesłać wyniki z powrotem do API w kolejnej wiadomości.

Ten proces jest identyczny z tym, jak używałbyś klucza API github copilot z modelami Microsoftu. Zaletą tutaj jest spójność. Jeśli masz istniejący kod do wywoływania narzędzi, prawdopodobnie możesz go ponownie wykorzystać przy minimalnych dostosowaniach. Upewnij się tylko, że definicje Twoich narzędzi pasują do oczekiwanego schematu dla modelu uncensored.

Monitorowanie użycia

Ponieważ płacisz za token, monitorowanie swojego użycia jest ważne, aby uniknąć nieoczekiwanych kosztów. API Cursor zapewnia panel, w którym możesz wyświetlać saldo kredytu i historię użycia. Możesz zobaczyć, ile tokenów zużyłeś i ile kredytu pozostało.

Kluczowe limity do obserwacji:

• Limit zapytań: 300 zapytań na minutę na klucz.
• Rozmiar ciała żądania: Maksymalnie 8 MB na zapytanie.
• Okno kontekstu: 100 000 tokenów łącznie (wejście + wyjście).

Jeśli przekroczysz limit zapytań, otrzymasz błąd 429. Możesz monitorować swoje użycie w czasie rzeczywistym, aby upewnić się, że pozostajesz w tych granicach. Dodatkowo możesz wygenerować ponownie swój klucz API, jeśli podejrzewasz, że został naruszony, co natychmiast unieważnia stary klucz.

Rozwiązywanie typowych problemów

Nawet przy solidnym API mogą pojawiać się problemy. Oto niektóre powszechne problemy i ich rozwiązania.

401 Nieautoryzowany: Sprawdź swój klucz API. Upewnij się, że został skopiowany poprawnie i nie ma spacji na początku ani końcu. Jeśli wygenerowałeś ponownie klucz, upewnij się, że używasz nowego.

429 Zbyt wiele żądań: Przekroczyłeś limit 300 zapytań na minutę. Zaimplementuj wykładnicze opóźnienie ponownych prób w swoim kliencie lub zmniejsz częstotliwość swoich żądań.

400 Nieprawidłowe żądanie: Zazwyczaj wskazuje to na niepoprawnie sformatowaną ładunek JSON lub brak wymaganych pól. Upewnij się, że Twoja tablica messages jest poprawnie sformatowana i zawiera pola role oraz content. Sprawdź również, czy nazwa modelu to dokładnie uncensored.

Blokowanie treści: Choć model jest bez cenzury, blokuje on treści seksualne involving małoletnich. Jeśli Twoje żądanie zostało zablokowane, może to wynikać z tego konkretnego twardego limitu.