PL ▾
Pobierz klucz API

deepseek4api.comPrzewodnik

AI bez cenzury w VS Code: Continue, Cline i Cursor

Konfiguracja API deepseek v4 w stylu VS Code sprowadza się do trzech wartości: Base URL, klucz API i ID modelu. Ten poradnik pokazuje dokładnie, gdzie wkleić je w Continue, Cline i Cursor, jak przetestować połączenie i co zrobić, gdy nie zadziała.

Zaktualizowano

Izometryczna ilustracja panelu edytora kodu połączonego kablem ze świecącym węzłem chmury, reprezentującym endpoint API

Kluczowe punkty

  • Działa każde rozszerzenie edytora z niestandardowym dostawcą kompatybilnym z OpenAI: użyj adresu bazowego https://api.deepseek4api.com/v1 i identyfikatora modelu uncensored.
  • Przetestuj za pomocą curl zapytanie GET /v1/models przed interakcją z edytorem, aby upewnić się, że klucz i URL są poprawne.
  • API obsługuje tylko uzupełnienia czatu, więc używaj go do czatu, edycji i agentów, a nie do automatycznego uzupełniania kodu przy klawiszu Tab.
  • Typowe pytanie programistyczne z kontekstem 8000 tokenów kosztuje około $0,0017.

Czego potrzebujesz przed rozpoczęciem

Edytory pozwalające na podanie własnego modelu zawsze pytają o te same trzy rzeczy. Oto one dla tej usługi.

UstawienieWartość
Base URLhttps://api.deepseek4api.com/v1
Klucz APITwój klucz ze strony klucz API, wysyłany jako Authorization: Bearer
ID modeluuncensored
Typ dostawcy"OpenAI" lub "OpenAI-compatible"

Szybkie wyjaśnienie, aby nic Cię później nie zaskoczyło. Nazwa tej witryny wspomina o DeepSeek V4, ale modelem za endpointem jest jeden model o otwartych wagach uruchamiany przez niezależnego dostawcę. Nie jest to oficjalne API DeepSeek. W edytorze wybierz ogólny dostawcę kompatybilny z OpenAI, a nie dostawcę przypisanego do jednego producenta, ponieważ dostawca przypisany do jednego producenta wskazuje na serwery tego producenta i ignoruje Twój adres bazowy.

Nowi użytkownicy mogą jednorazowo uzyskać $0,50 kredytu próbnego po rejestracji, bez karty kredytowej, co wystarczy do testów poniżej. Klucz próbny obsługuje 2 równoległe zapytania i 60 zapytań na minutę.

Przetestuj endpoint z terminala

Połowa problemów z konfiguracją edytora to błędny URL lub literówka w kluczu, a edytory źle informują, który z nich jest problemem. Dwa polecenia curl usuwają zgadywanie. Otwórz terminal w VS Code (Ctrl+` w Windows i Linux, Cmd+` w macOS) i uruchom pierwsze.

# expect the model id "uncensored" in the list
curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Powinieneś zobaczyć listę JSON zawierającą model uncensored. Teraz wyślij prawdziwe zapytanie czatu:

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

Jeśli oba zadziałają, edytor zadziała z tymi samymi wartościami. Jeśli pierwsze zwróci błąd autoryzacji, klucz jest błędny lub zawiera zbędne spacje. Jeśli otrzymasz 404, sprawdź, czy URL kończy się na /v1 i nie ma po nim dodatkowej ścieżki.

Continue w VS Code

Continue to open-source'owe rozszerzenie asystenta dla VS Code i JetBrains. Zainstaluj je z widoku Rozszerzenia, otwórz jego panel i otwórz plik konfiguracyjny z ikony koła zębatego. W obecnych wersjach plik to config.yaml, a wpis modelu dla tego API wygląda tak:

models:
  - name: Uncensored API
    provider: openai
    model: uncensored
    apiBase: https://api.deepseek4api.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply
    defaultCompletionOptions:
      contextLength: 100000
      maxTokens: 2000
      temperature: 0.4

Starsze wersje Continue używają config.json z tablicą models, gdzie te same pola pojawiają się jako "provider": "openai", "model": "uncensored" i "apiBase": "https://api.deepseek4api.com/v1". Format pliku zmienił się między wersjami, więc jeśli Twój panel pokazuje inny układ, postępuj zgodnie ze strukturą wygenerowaną przez Continue i zamień te trzy wartości.

Długość kontekstu 100000 pasuje do okna tego API (prompt plus uzupełnienie). Niższa wartość maxTokens jest górnym limitem długości każdej odpowiedzi. Chroni Cię przed długą odpowiedzią, której nie potrzebowałeś. Zapisz plik, wybierz model w rozwijanej liście czatu Continue i zadaj pytanie o otwarty plik. Podświetl kod i użyj polecenia edycji, aby przepisać zaznaczenie.

Cline

Cline to rozszerzenie w stylu agenta, które czyta pliki, proponuje edycje i wykonuje polecenia za Twoją zgodą. Otwórz jego ustawienia, wybierz dostawcę API o nazwie "OpenAI Compatible" i wypełnij pola:

  1. Base URL: https://api.deepseek4api.com/v1
  2. API Key: Twój klucz
  3. Identyfikator modelu: uncensored

Agenci są gadatliwi. Pojedyncze zadanie może wywołać tuzin zapytań, gdy narzędzie czyta pliki, edytuje je i sprawdza wyniki, a każde zapytanie ponownie wysyła dotychczasową rozmowę. Tutaj liczy się matematyka kosztów. Załóżmy, że krok agenta zawiera 40 000 tokenów kontekstu i generuje 1500 tokenów. Kosztuje to 40 000 x $0,15 / 1M plus 1500 x $0,50 / 1M, czyli $0,006 plus $0,00075, czyli $0,00675. Dwadzieścia takich kroków dla jednego zadania to $0,135. Rozpoczynaj nowe zadania zamiast pozwalać jednej rozmowie rosnąć przez godziny, a Twój rachunek pozostanie stały.

API obsługuje wywoływanie funkcji (tools, tool_choice i strumieniowane tool_calls, z wynikami zwracanymi jako role: "tool"), na którym polegają rozszerzenia agenta. Sprawdź dokumentację, aby poznać dokładny kształt zapytania, jeśli budujesz własnego agenta.

Cursor i inne edytory

Cursor to osobny edytor zbudowany na bazie kodu VS Code. Ma stronę ustawień modelu, gdzie możesz wpisać swój klucz OpenAI i nadpisać adres bazowy OpenAI. Wklej tam https://api.deepseek4api.com/v1, wklej swój klucz i dodaj niestandardowy model o nazwie uncensored. Opcje i zasady planu Cursora zmieniają się od czasu do czasu, więc sprawdź jego aktualną dokumentację, gdzie znajduje się to nadpisanie i które funkcje go używają. Funkcje działające na własnych modelach Cursora, takie jak uzupełnianie klawiszem Tab, nie przechodzą przez Twój endpoint.

Ta sama metoda działa w dowolnym narzędziu oferującym niestandardowego dostawcę kompatybilnego z OpenAI: Zed, wtyczki JetBrains, wtyczki Neovim, asystenci terminala i Twoje własne skrypty. Jeśli narzędzie akceptuje tylko stałą listę dostawców, poszukaj zmiennej środowiskowej. Wiele narzędzi opartych na OpenAI odczytuje OPENAI_BASE_URL i OPENAI_API_KEY, które możesz ustawić w powłoce:

# base URL https://api.deepseek4api.com/v1, model uncensored
export OPENAI_BASE_URL="https://api.deepseek4api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
# then select the model name "uncensored" inside the tool

Co działa dobrze, a co nie

Oto, jak dobrze to API pasuje do przepływów pracy programistycznych.

  • Działa: rozmowa o Twoim kodzie, wyjaśnianie błędów, pisanie funkcji, refaktoryzacja zaznaczenia, generowanie testów, pisanie wiadomości commit, narzędzia agenta wywołujące funkcje.
  • Nie działa: automatyczne uzupełnianie w miejscu, które zależy od endpointów fill-in-the-middle. API udostępnia tylko POST /v1/chat/completions i GET /v1/models, więc nie ma starej trasy uzupełnień. Zachowaj inne narzędzie do uzupełniania klawiszem Tab, jeśli z niego korzystasz.
  • Niedostępne: osadzanie (embeddings), więc rozszerzenia indeksujące Twoją bazę kodu za pomocą modelu embedding potrzebują osobnego źródła embeddingów. To samo dotyczy generowania obrazów, audio i wideo oraz dostrajania (fine-tuning).

Model to ogólnego przeznaczenia model tekstowy, który nie odmawia w przypadku zgodnego z prawem użytku przez dorosłych. Nie składamy żadnych twierdzeń benchmarkowych dotyczących programowania, więc oceń go na własnym kodzie. Używaj niskiej temperatury dla kodu, około 0,2 do 0,4, i podaj rozszerzeniu jasną instrukcję dotyczącą języka i stylu.

Jeśli chodzi o koszt, pytanie programistyczne wysyłające 8000 tokenów kontekstu pliku i otrzymujące odpowiedź 1000 tokenów kosztuje 8000 x $0,15 / 1M plus 1000 x $0,50 / 1M, czyli $0,0012 plus $0,0005, czyli $0,0017. Sto takich dziennie przez 22 dni to 2200 wywołań i $3,74. Zobacz stronę cenową, aby poznać poziomy doładowania.

Rozwiązywanie typowych błędów

ObjawPrawdopodobna przyczynaNaprawa
401 lub błąd autoryzacjiBłędny klucz, dodatkowa spacja lub klucz wklejony w złym poluSkopiuj ponownie klucz, a następnie powtórz test curl
404 nie znalezionoW Base URL brakuje /v1 lub na końcu jest dodatkowa ścieżkaUżyj dokładnie https://api.deepseek4api.com/v1
Model nie znalezionyNazwa modelu wpisana inaczejUżyj uncensored małymi literami
429 z concurrencyZbyt wiele zapytań naraz, jak na Twój klucz (8 dla zwykłego klucza, 2 dla próbnego)Zmniejsz równoległe zapytania rozszerzenia lub poczekaj
429 z rate_limitedPowyżej 300 zapytań na minutę (60 dla klucza próbnego)Zwolnij agenta lub grupuj kroki
429 z Retry-After: 5Tymczasowe przeciążeniePonów próbę po pięciu sekundach
Zapytanie zbyt dużeTreść przekracza 8 MBWyślij mniej lub mniejsze pliki jako kontekst

Strumieniowane odpowiedzi zajmują slot równoległości do momentu zakończenia strumienia, więc jeśli otworzysz wiele okien czatu naraz z kluczem próbnym, osiągniesz limit równoległości szybciej, niż się spodziewasz. Sprawdź nagłówki odpowiedzi X-RateLimit-Limit-Requests i X-RateLimit-Limit-Concurrency, aby potwierdzić, co pozwala Twój klucz, oraz nagłówek X-Balance-USD, aby zobaczyć, ile zostało kredytu. Nieudane zapytania nie są rozliczane, więc ponowne próby są darmowe.

Pytania i odpowiedzi

Jaki identyfikator modelu wpisuję w VS Code?

Wpisz uncensored, małymi literami, wraz z Base URL https://api.deepseek4api.com/v1 i swoim kluczem API. Wybierz typ dostawcy kompatybilnego z OpenAI w rozszerzeniu.

Czy to oficjalne API DeepSeek V4?

Nie. To jeden model o otwartych wagach uruchamiany przez niezależnego dostawcę i nie jest to oficjalne API DeepSeek ani żadnego innego dostawcy.

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

Nie do uzupełniania w środku tekstu. API oferuje tylko uzupełnienia czatu i listę modeli. Działa do czatu, edycji i narzędzi agenta.

Dlaczego otrzymuję błędy 429 w rozszerzeniu agenta?

Agenci wysyłają wiele zapytań jednocześnie. Zwykły klucz pozwala na 8 równoległych zapytań i 300 na minutę, a klucz próbny pozwala na 2 i 60. Zmniejsz równoległość lub ponów próbę po opóźnieniu Retry-After.

Twój klucz jest o jeden formularz stąd

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