PL ▾
Pobierz klucz API

uncensoredqwen.comPrzewodnik

Klucz API Qwen dla VS Code: Konfiguracja własnego endpointu

Aby użyć klucza API Qwen dla VS Code, nie potrzebujesz wtyczki specyficznej dla Alibaba. Każde rozszerzenie obsługujące dostawcę kompatybilnego z OpenAI przyjmuje trzy wartości: base URL, klucz i nazwę modelu. Ten przewodnik podaje dokładne wartości i sprawdzenia, które wyłapują typowe błędy.

Zaktualizowano

Izometryczny panel edytora kodu ze złotym kluczem włożonym w gniazdo endpointu połączone z serwerem

Czego potrzebujesz przed otwarciem VS Code

Klucz API Qwen dla VS Code to po prostu klucz API plus odpowiednie ustawienia endpointu w rozszerzeniu. Zbierz najpierw te trzy wartości:

  • Adres URL bazowy: https://api.uncensoredqwen.com/v1
  • Identyfikator modelu: uncensored
  • Klucz API: utworzony na stronie kluczy API po zalogowaniu się przez Google lub e-mail i hasło

Nowe konta mogą odebrać $0,50 kredytu próbnego jednym kliknięciem na tej stronie. Nie wymaga karty, jest limitowane do jednego na osobę i jest ważne przez 7 dni. To wystarczy na przetestowanie konfiguracji edytora przez kilka dni rzeczywistego kodowania.

Uwaga dotycząca nazewnictwa: usługa to hostowany model o otwartych wagach uruchamiany przez niezależnego dostawcę. Nie jest to oficjalne API Alibaba i nie jest to router do innych dostawców. W Twoim edytorze pojawi się pod dowolną nazwą wyświetlaną, którą mu nadasz.

Przetestuj klucz najpierw za pomocą curl

Przed zmianą dowolnego ustawienia edytora potwierdź, że klucz i URL działają osobno. Jeśli to nie zadziała, żadne rozszerzenie nie zadziała, a będziesz wiedział, że problemem jest klucz, a nie wtyczka.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Lista JSON zawierająca uncensored oznacza, że uwierzytelnianie działa. Następnie wyślij jedno rzeczywiste zapytanie o uzupełnienie:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

Nagłówki odpowiedzi zawierają X-Balance-USD, co jest szybkim sposobem na sprawdzenie pozostałego kredytu bez wychodzenia z terminala.

Dodaj dostawcę w rozszerzeniu VS Code

Wiele rozszerzeń VS Code do wspomagania programowania AI może komunikować się z dowolnym serwerem kompatybilnym z OpenAI. Etykiety różnią się nieco w zależności od narzędzia, ale pola odpowiadają sobie jedno do jednego. Szukaj opcji dostawcy nazwanej np. „OpenAI Compatible”, „OpenAI” z niestandardowym adresem URL bazowym lub „Niestandardowy endpoint”.

Pole rozszerzeniaWartość do wpisania
DostawcaKompatybilny z OpenAI (lub OpenAI z niestandardowym base URL)
Base URL / baza URL APIhttps://api.uncensoredqwen.com/v1
Klucz APITwój klucz z konta
ID modeluuncensored

Rozszerzenia odczytujące plik konfiguracyjny JSON zwykle oczekują czegoś w tym kształcie. Dokładne nazwy kluczy się różnią, więc sprawdź dokumentację swojego rozszerzenia i dostosuj nazwy pól:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Nie zatwierdzaj tego pliku. Jeśli Twoje ustawienia znajdują się w repozytorium, użyj tajnego magazynu rozszerzenia lub zmiennej środowiskowej, a następnie dodaj ścieżkę konfiguracji do .gitignore.

Po zapisaniu otwórz panel czatu rozszerzenia i wyślij krótką wiadomość, np. "Wyjaśnij tę funkcję", mając otwarty plik. Strumieniowana odpowiedź oznacza, że konfiguracja jest zakończona.

Napraw typowe błędy konfiguracji

Większość nieudanych konfiguracji sprowadza się do kilku literówek. Przejdź przez tę listę kolejno.

URL ma niewłaściwy kształt

Base URL kończy się na /v1. Rozszerzenia same dodają /chat/completions. Jeśli wkleisz pełną ścieżkę, otrzymasz błąd 404, ponieważ klient żąda /v1/chat/completions/chat/completions. Końcowy slash jest zwykle nieszkodliwy, ale brak /v1 już nie.

Nazwa modelu jest błędna

Niektóre rozszerzenia automatycznie wypełniają listę rozwijaną modeli nazwami z innego serwisu. Zmień ją dokładnie na uncensored, małymi literami. Jeśli pole jest listą rozwijaną bez opcji niestandardowej, poszukaj opcji „custom model” lub „other”.

Klucz zawiera zbędne znaki

Kopiowanie ze strony internetowej może dodać spację lub znak nowej linii na końcu. Wklej do edytora tekstu, usuń zbędne znaki i wklej ponownie. Odpowiedź 401 prawie zawsze wskazuje na to lub na klucz z innego konta.

Rozszerzenie nadal komunikuje się z domyślnym serwerem

Jeśli Twój balans nie zmienia się po żądaniach czatu, edytor może używać wbudowanego dostawcy. Sprawdź, czy aktywny profil modelu to ten, który edytowałeś, i przeładuj okno po zmianie ustawień.

Zapytania kończą się błędem 429

To limit zapytań, opisany w następnej sekcji. Treść błędu zawiera kod informujący, jaki limit przekroczyłeś.

Sprawdź, czy zapytania faktycznie docierają do API

Edytory rzadko mówią, który serwer odpowiedział. Dwa szybkie sprawdzenia usuwają wątpliwości.

  1. Obserwuj balans. Uruchom /v1/models lub krótkie wywołanie uzupełnienia z terminala, zanotuj nagłówek X-Balance-USD, wyślij trzy wiadomości czatu w edytorze, a następnie powtórz wywołanie w terminalu. Liczba powinna spaść o niewielką kwotę. Ta sama figura jest dostępna z GET /v1/balance.
  2. Poproś o coś, co domyślna konfiguracja odrzuciłaby lub obsłużyłaby inaczej. Małym, nieszkodliwym testem jest poproszenie o odpowiedź dokładnie w pięciu słowach. Jeśli odpowiedź spełnia instrukcję i przychodzi strumieniowo, połączenie jest zdrowe.

Jeśli balans się nie zmienia, otwórz panel wyjścia rozszerzenia lub konsolę deweloperską. Większość rozszerzeń loguje URL żądania i status HTTP, a niewłaściwy host pojawia się natychmiast. Popraw base URL, przeładuj okno i spróbuj ponownie.

Zespoły dzielące się repozytorium powinny dać każdej osobie osobny klucz zamiast jednej wspólnej wartości. Dzięki temu limit zapytań przekroczony przez jedną osobę nie blokuje innych, a wycieknięty klucz można zastąpić bez zakłócania pracy pozostałym.

Autouzupełnianie, czat i limity zapytań

Czat jest łagodny dla limitów: jedno zapytanie na wiadomość. Autouzupełnianie w miejscu jest inne. Wiele rozszerzeń wysyła żądanie przy krótkiej pauzie w pisaniu, co może generować dziesiątki wywołań na minutę podczas pracy.

Znaj liczby. Pełny klucz pozwala na 8 równoległych żądań i 300 zapytań na minutę. Klucz próbny pozwala na 2 równoległe i 60 na minutę. Gdy je przekroczysz, API odpowiada HTTP 429 i kodem rate_limited (za dużo na minutę) lub concurrency (za dużo naraz). Przy tymczasowym przeciążeniu otrzymujesz również 429 z nagłówkiem Retry-After: 5. Strumieniowane uzupełnienie zajmuje slot równoległości do końca strumienia, więc wolne strumienie dłużej obciążają limit.

Praktyczne ustawienia, które pomogą:

  • Używaj usługi do czatu, edycji i wyjaśnień, a wyłącz autouzupełnianie w tabulaturze lub zwiększ opóźnienie debounce podczas korzystania z klucza próbnego.
  • Obniż maksymalną liczbę tokenów wyjściowych dla autouzupełniania do kilkunastu. Krótkie uzupełnienia kończą się szybko i zwalniają slot.
  • Unikaj uruchamiania wielu okien edytora przeciwko temu samemu kluczowi podczas okresu próbnego.

Nieudane lub odrzucone zapytania nie są rozliczane, więc błędy nie kosztują nic poza czasem.

Koszt sesji programistycznej

Prompty do kodowania są obciążone danymi wejściowymi, ponieważ rozszerzenia dołączają zawartość plików. Ceny wynoszą $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych. Rozważ jedną turę czatu, która wysyła 6 000 tokenów kodu i kontekstu oraz otrzymuje 800 tokenów z powrotem:

  • Wejście: 6000 x $0,15 / 1000000 = $0,0009
  • Wyjście: 800 x $0,50 / 1 000 000 = $0,0004
  • Łącznie: $0,0013 za turę

Przy 100 takich turach w ciągu dnia roboczego koszt wynosi $0,13. Kredyt próbny $0,50 wystarcza na około 380 tur tego rozmiaru ($0,50 / $0,0013 to około 385). Kredyt jest przedpłacony, nie wygasa, a doładowania mają kwoty całkowite od $20 do $500, z bonusem 5% od $50, 10% od $100 i 15% od $200. Zobacz stronę z cenami, aby poznać metody płatności.

Okno kontekstu wynosi 100 000 tokenów, łącznie z promptem i uzupełnieniem. Jeśli rozszerzenie indeksuje cały repozytorium do każdego promptu, duże zapytania będą kosztować więcej i zbliżać się do tego limitu. Zwęż kontekst do plików, których faktycznie potrzebujesz.

Prywatność i gdzie przeczytać więcej

Prompty nie są używane do trenowania. Mimo to kod źródłowy często zawiera dane poufne, więc trzymaj pliki .env i dane uwierzytelniające z dala od plików dołączanych do czatu. Większość rozszerzeń pozwala wykluczyć ścieżki z kontekstu.

Model jest tylko tekstowy. Odpowiada na pytania programistyczne, pisze funkcje, wyjaśnia błędy i obsługuje wywoływanie funkcji oraz tryb JSON, ale nie generuje obrazów, dźwięku ani wideo. Aby poznać pola zapytań i przykłady wykraczające poza tę stronę, przeczytaj dokumentację API. Jeśli coś nadal nie działa po powyższych sprawdzeniach, wcześniejszy artykuł na temat częstych błędów w API Qwen wymienia więcej wzorców błędów z rozwiązaniami.

Pytania i odpowiedzi

Gdzie zdobyć klucz API Qwen dla VS Code?

Zarejestruj się na stronie, otwórz stronę klucza API i utwórz klucz. Możesz tam również odebrać jednorazowy kredyt próbny za $0,50 bez podawania karty.

Jaki bazowy URL wpisać w rozszerzeniu?

Użyj https://api.uncensoredqwen.com/v1 i pomijaj /chat/completions. ID modelu to uncensored.

Dlaczego moje rozszerzenie zwraca 401?

Klucz jest zwykle niepoprawny, zawiera przypadkową spację lub należy do innego konta. Skopiuj go ponownie i przetestuj za pomocą wywołania curl do /v1/models.

Czy mogę go używać do autouzupełniania w edytorze kodu?

Działa przez ustawienia autouzupełniania zgodne z OpenAI, ale częste żądania mogą osiągnąć limit próbny 60 na minutę. Pełny klucz pozwala na 300 na minutę.

Twój klucz jest o jeden formularz stąd

Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.

Pobierz klucz API