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.

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.
| Ustawienie | Wartość |
|---|---|
| Base URL | https://api.deepseek4api.com/v1 |
| Klucz API | Twój klucz ze strony klucz API, wysyłany jako Authorization: Bearer |
| ID modelu | uncensored |
| 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:
- Base URL:
https://api.deepseek4api.com/v1 - API Key: Twój klucz
- 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/completionsiGET /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
| Objaw | Prawdopodobna przyczyna | Naprawa |
|---|---|---|
| 401 lub błąd autoryzacji | Błędny klucz, dodatkowa spacja lub klucz wklejony w złym polu | Skopiuj ponownie klucz, a następnie powtórz test curl |
| 404 nie znaleziono | W Base URL brakuje /v1 lub na końcu jest dodatkowa ścieżka | Użyj dokładnie https://api.deepseek4api.com/v1 |
| Model nie znaleziony | Nazwa modelu wpisana inaczej | Użyj uncensored małymi literami |
429 z concurrency | Zbyt 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_limited | Powyżej 300 zapytań na minutę (60 dla klucza próbnego) | Zwolnij agenta lub grupuj kroki |
429 z Retry-After: 5 | Tymczasowe przeciążenie | Ponów próbę po pięciu sekundach |
| Zapytanie zbyt duże | Treść przekracza 8 MB | Wyś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.
Więcej przewodników
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.