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 rozszerzenia | Wartość do wpisania |
|---|---|
| Dostawca | Kompatybilny z OpenAI (lub OpenAI z niestandardowym base URL) |
| Base URL / baza URL API | https://api.uncensoredqwen.com/v1 |
| Klucz API | Twój klucz z konta |
| ID modelu | uncensored |
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.
- Obserwuj balans. Uruchom
/v1/modelslub krótkie wywołanie uzupełnienia z terminala, zanotuj nagłówekX-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 zGET /v1/balance. - 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.
