getdeepseekapi.comPrzewodnik
URL i Base URL DeepSeek API: Jak przełączyć
URL API DeepSeek, który kopiujesz z własnej dokumentacji DeepSeek, to URL bazowy i działa tylko z kluczem DeepSeek i modelami DeepSeek. Jeśli chcesz innego endpointu w stylu OpenAI, zmień ten URL, klucz i ID modelu.
Zaktualizowano
Kluczowe punkty
- Podstawowy adres URL to prefiks; SDK dodaje do niego /chat/completions.
- Ta usługa używa https://api.getdeepseekapi.com/v1 z ID modelu uncensored.
- To nie jest API DeepSeek, więc klucz DeepSeek nie zadziała tutaj i odwrotnie.
- Większość klientów akceptuje również URL i klucz przez zmienne OPENAI_BASE_URL i OPENAI_API_KEY.

Podstawowy adres URL, punkt końcowy oraz ścieżka: trzy części
Często ludzie wklejają pełny adres w pole oczekujące prefiksu i dostają 404. Trzy pojęcia pomagają to rozróżnić.
- Podstawowy adres URL: wspólny przedrostek każdego wywołania, np.
https://api.getdeepseekapi.com/v1. To jest to, co wpisujesz w ustawieniu „API base” lub „Base URL” klienta. - Ścieżka endpointu: część dodawana przez SDK, np.
/chat/completions,/responseslub/models. - Pełny adres URL: baza plus ścieżka, np.
https://api.getdeepseekapi.com/v1/chat/completions. Narzędzia HTTP bez warstwy abstrakcji, takie jak curl, potrzebują tego.
Zasada, która łapie większość osób: biblioteki SDK i aplikacje pytają o podstawowy adres URL, curl i węzły HTTP pytają o pełny adres URL. Jeśli narzędzie zwraca błąd 404, sprawdź najpierw, czy wstawiłeś pełny adres URL tam, gdzie oczekiwano podstawowego, czy odwrotnie. Zduplikowana ścieżka, taka jak /v1/chat/completions/chat/completions w błędzie, jest tym sygnałem.
Czym jest bazowy URL DeepSeek i czym nie jest
DeepSeek publikuje swój adres API w dokumentacji wraz z nazwami modeli, których może używać klucz. Sprawdź tam aktualną wartość zamiast ufać wpisom na blogach, w tym temu. Klucz DeepSeek działa na endpointie DeepSeek i nigdzie indziej.
Usługa na tej stronie to osobny produkt. Nie jest to oficjalne API DeepSeek, nie przekierowuje do DeepSeek i nie obsługuje modeli DeepSeek. To hostowane API kompatybilne z OpenAI dla jednego modelu o otwartych wagach, prowadzone przez niezależnego dostawcę i dostrojone do odpowiadania bez odmów treści dla zgodnego z prawem użytku przez dorosłych. Jego adres to:
https://api.getdeepseekapi.com/v1 # model: uncensored
ID modelu to uncensored, a uwierzytelnianie odbywa się przez Authorization: Bearer <key>. Klucze wystawia się na stronie klucza API. Jeśli porównujesz, co klucz oznacza dla poszczególnych usług, na stronie klucz API DeepSeek znajdziesz więcej szczegółów.
Zmiana endpointów w SDK OpenAI
Dowolne SDK OpenAI zadziała po zmianie bazowego URL i klucza. W Pythonie:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
W Node.js pole nazywa się baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Zwróć uwagę na różnicę: Python używa base_url, Node używa baseURL. Ich pomyłne pomieszanie powoduje przejście do domyślnego adresu OpenAI, co skutkuje odrzuceniem Twojego klucza.
Zmiana bez dotykania kodu
Oficjalne SDK OpenAI odczytują dwie zmienne środowiskowe, więc istniejącą aplikację można przekierować bez zmiany kodu:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
Nazwa modelu to część, której nie można pominąć. Jeśli aplikacja ma na sztywno zdefiniowany inny identyfikator modelu, poprosi o niego i się nie powiedzie, więc zmień go na uncensored w ustawieniach lub konfiguracji aplikacji. Wiele narzędzi udostępnia wszystkie trzy wartości na jednym ekranie ustawień, zwykle oznaczonym jako bazowy URL API, klucz API i model.
Ta sama zamiana trzech wartości działa w frameworkach. Na przykład w LangChain w Pythonie wystarczy ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored"). Narzędzia programistyczne, które akceptują endpoint kompatybilny z OpenAI, działają w ten sam sposób; zobacz przewodnik na stronie o używaniu API do kodowania.
Czysty HTTP: dokładne ścieżki
Dla curl, skryptów i węzłów HTTP budujesz pełny URL samodzielnie. Oto ścieżki dla tej usługi:
| Cel | Metoda i URL |
|---|---|
| Czat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API Responses | POST https://api.getdeepseekapi.com/v1/responses |
| Lista modeli | GET https://api.getdeepseekapi.com/v1/models |
| Saldo | GET https://api.getdeepseekapi.com/v1/balance |
| Saldo w stylu OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Używaj tylko HTTPS. Strumieniowanie działa z "stream": true przez zdarzenia wysyłane przez serwer, a ten sam URL obsługuje oba tryby.
Wprowadzanie URL w aplikacjach z ekranem ustawień
Wiele interfejsów czatu, edytorów i narzędzi automatyzacji ma opcję „niestandardowego endpointu kompatybilnego z OpenAI”. Etykiety się różnią, ale pola odpowiadają sobie jeden do jednego:
| Pole w aplikacji | Wartość |
|---|---|
| URL bazowy API, Base URL, Endpoint, URL serwera | https://api.getdeepseekapi.com/v1 |
| Klucz API, Token, Sekret | Twój klucz z tej usługi |
| Model, Nazwa modelu, ID modelu | uncensored |
Niektóre aplikacje chcą pełnego URL czatu zamiast bazy. W takim przypadku użyj https://api.getdeepseekapi.com/v1/chat/completions. Jeśli aplikacja ma przycisk „test połączenia”, zwykle wywołuje listę modeli, czyli GET /v1/models. Jeśli przycisk nie działa, ale ręczny czat działa, sprawdzenie aplikacji jest surowsze niż API i możesz je zignorować.
Szybki test poprawności samego URL
Zanim zaczniesz debugować aplikację, sprawdź URL za pomocą listy modeli. Nie wymaga ciała żądania i nic nie kosztuje:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Powinieneś otrzymać odpowiedź JSON z tablicą „data”. Strona błędu HTML oznacza nieprawidłowy host lub ścieżkę, np. brakującą subdomenę: host zaczyna się od api., a nie www..
Naprawianie typowych błędów
- 404 Not Found. Brakuje
/v1w bazowym URL, występuje dwukrotnie lub zawiera ścieżkę endpointu. - 401 lub błąd uwierzytelnienia. Użyłeś klucza z innej usługi lub nagłówek nie zawiera
Bearer. Klucze nie są wymienne między dostawcami. - Nie znaleziono modelu. Zapytanie nadal wskazuje model ze starego dostawcy. Ustaw
uncensored. - Aplikacja nadal łączy się ze starą usługą. Niektóre narzędzia buforują ustawienia lub odczytują inną zmienną. Uruchom proces ponownie i sprawdź ekran ustawień.
- Problem z końcowym znakiem ukośnika. Większość klientów sobie z tym radzi, ale jeśli któryś nie, usuń końcowy ukośnik z adresu URL.
Jeśli nie jesteś pewien, po której stronie następuje błąd, wyślij powyższe polecenie curl. Odpowiedź 200 potwierdza adres URL, klucz i model; wszystko inne, co się psuje, jest w twojej aplikacji. Dokumentacja zawiera limity i nagłówki, takie jak X-Request-Id, co pomaga przy kontakcie z działem wsparcia.
Co pozostaje bez zmian po przełączeniu
Struktura żądań i odpowiedzi odpowiada formatowi OpenAI, więc tablice wiadomości, temperature, top_p, stop, seed, kary, wywoływanie funkcji i tryb JSON działają standardowo. Okno kontekstu wynosi 100 000 tokenów dla prompt plus uzupełnienie, a maksymalny rozmiar ciała żądania to 8 MB. Usługa obsługuje tylko tekst: bez obrazów, audio, embeddingów ani dostrajania, więc funkcje oparte na tych danych wymagają innego dostawcy.
Rozliczenie jest również oddzielone od starego dostawcy: $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych z przedpłaconego kredytu, jak pokazano na stronie z cenami. Nowi użytkownicy mogą odebrać $0,50 darmowego kredytu próbnego, aby sprawdzić, czy przełączenie działa, przed dokonaniem jakiejkolwiek płatności.
Więcej przewodników
Pytania i odpowiedzi
Jaki jest bazowy adres URL API DeepSeek?
DeepSeek publikuje go w swojej dokumentacji, więc sprawdź tam aktualną wartość. Endpoint na tej stronie to inna usługa w https://api.getdeepseekapi.com/v1.
Czy mogę użyć klucza DeepSeek na tym endpointzie?
Nie. Klucze są wydawane dla każdej usługi osobno. Pobierz klucz dla tego API na stronie kluczy i ustaw model na uncensored.
Czy bazowy adres URL powinien kończyć się na /v1?
Tak, dla tej usługi: https://api.getdeepseekapi.com/v1. SDK dodaje ścieżkę endpointu po nim, więc nie dodawaj /chat/completions samodzielnie.
Dlaczego otrzymuję 404 po zmianie adresu URL?
Zwykle ścieżka jest podwójna lub brakuje /v1. Porównaj swój bazowy adres URL z dokładną wartością podaną powyżej.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy adres URL. To cała konfiguracja.