deepseek4api.comPrzewodnik
Przewodnik po dokumentacji API DeepSeek i zamiennik
Większość osób otwierających dokumentację API deepseek szuka pięciu odpowiedzi: base URL, sposób uwierzytelniania, nazwa modelu, dostępne parametry i przykładowe wywołanie. Ta strona to omawia, a następnie pokazuje te same wywołania wobec innego endpointu kompatybilnego z OpenAI, który możesz wstawić.


Kluczowe punkty
- DeepSeek dokumentuje API w stylu OpenAI, więc SDK OpenAI działa po zmianie base URL, klucza i nazwy modelu.
- Ta strona nie jest oficjalnym API DeepSeek; obsługuje jeden niezależny model o otwartych wagach pod ID uncensored.
- Ten sam kod działa na obu: zmieniają się tylko trzy wartości.
- Okno kontekstu wynosi 100 000 tokenów, obsługiwane są strumieniowanie, narzędzia i tryb JSON.
Pięć rzeczy, na które odpowiada dokumentacja API DeepSeek
Gdy programiści szukają dokumentacji API deepseek, zwykle chcą zrealizować pierwsze zapytanie. Wzorzec jest taki sam jak w przypadku dowolnej usługi w stylu OpenAI, dlatego tabela ułatwia porównanie.
| Pytanie | Dokumentacja DeepSeek | To API |
|---|---|---|
| Bazowy URL | Dokumentacja w szybkim starcie (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| Autoryzacja | Token Bearer w nagłówku Authorization | Token Bearer w nagłówku Authorization |
| Nazwa modelu | Wymienione w dokumentacji modeli; sprawdź aktualne nazwy | uncensored |
| Główny endpoint | Uzupełnianie czatu | Chat completions, Responses, lista modeli |
| Cennik | Sprawdź ich aktualne ceny | $0,15 / 1M tokenów wejściowych, $0,50 / 1M tokenów wyjściowych |
Przeczytaj oficjalne strony DeepSeek, aby uzyskać informacje o ich modelach, cenach i limitach; zmieniają się one, a ten artykuł nie próbuje ich przedstawić na nowo. Chodzi o to, że kształt żądania jest wspólny, więc przejście między jednym a drugim to zmiana konfiguracji.
Jedna rzecz, która powinna być jasna: ta strona nie jest oficjalnym API DeepSeek i nie jest routerem do DeepSeek. To hostowany endpoint kompatybilny z OpenAI, obsługujący jeden model o otwartych wagach uruchamiany przez niezależnego dostawcę i dostosowany do odpowiadania bez odrzuceń treści dla prawnego użytku przez osoby pełnoletnie.
Krok 1: uwierzytelnianie i base URL
Utwórz konto (Google lub e-mail i hasło) i otwórz stronę klucza API. Skopiuj klucz. Nowi użytkownicy mogą również jednym kliknięciem uzyskać darmowy kredyt próbny w wysokości $0,50, ważny przez 7 dni i nie wymagający karty.
Każde zapytanie zawiera nagłówek Authorization: Bearer YOUR_KEY. Z curl:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
To wypisuje dostępny model, uncensored. Jeśli skopiujesz przykład DeepSeek, zamień trzy rzeczy: base URL, klucz i nazwę modelu. Nic innego nie musi się zmienić.
Krok 2: chat completion w Pythonie
SDK OpenAI jest używane w przykładach dokumentacji DeepSeek i działa tutaj bez zmian:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
Obsługiwane parametry próbkowania, w tym temperature, top_p, stop, seed oraz kary za obecność i częstotliwość, są przekazywane dalej. max_tokens jest opcjonalny, ponieważ completion może użyć dowolnej pozostałej części okna 100 000 tokenów.
Krok 3: strumieniowanie, tryb JSON i narzędzia
Strumieniowanie
Ustaw stream: true, aby otrzymywać zdarzenia wysyłane przez serwer. Użycie jest raportowane na końcu strumienia.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
Tryb JSON
Przekaż response_format: {"type": "json_object"} i wspomnij o JSON w swoim prompcie. Wynikiem jest obiekt JSON, który możesz bezpośrednio zinterpretować.
Wywoływanie funkcji
Parametry tools i tool_choice działają w formacie OpenAI, wywołania narzędzi strumieniują w fragmentach, a wyniki zwracasz jako wiadomości z role: "tool". Jeśli twój kod już wywołuje funkcje w DeepSeek, powinien działać po zmianie trzech wartości powyżej, ale przetestuj własne schematy.
Gdzie się różnią
Ten sam protokół nie oznacza tej samej usługi. Sprawdź te rzeczy podczas przenoszenia obciążenia:
- Zachowanie modelu. Inny model daje inne odpowiedzi, styl rozumowania i zachowanie przy odmowach. Uruchom ponownie zestaw promptów przed przełączeniem czegokolwiek w produkcji.
- Pola specyficzne dla rozumowania. Jeśli zależy Ci na polach odpowiedzi specyficznych dla dostawcy z konkretnego modelu DeepSeek, nie zakładaj, że istnieją one tutaj. Standardowe pola completion czatu istnieją.
- Funkcje niedostępne. To API jest tylko tekstowe: bez obrazów, audio, wideo, embeddingów ani dostrajania.
- Limity. Pełny klucz pozwala na 8 równoległych zapytań i 300 na minutę; klucz próbny pozwala na 2 i 60. Po przekroczeniu limitu otrzymasz HTTP 429 z
rate_limitedlubconcurrency. - Saldo. Sprawdź kredyt za pomocą
GET /v1/balance, routingu grantów kredytowych w stylu OpenAI lub nagłówkaX-Balance-USDw każdej odpowiedzi.
Aby zobaczyć, jak użytkownik skoncentrowany na DeepSeek myśli o koszcie, zobacz uwagi dotyczące cen DeepSeek; dla konfiguracji edytorów zobacz przewodnik VS Code.
Ile kosztuje wywołanie tutaj
Rozliczenie jest z góry opłacone i za token: $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Żądanie z 1 500 tokenami wejściowymi i 600 tokenami wyjściowymi kosztuje 1 500 x $0,15 / 1M = $0,000225 za wejście plus 600 x $0,50 / 1M = $0,0003 za wyjście, co daje łącznie $0,000525. Doładowanie na kwotę $20 pokrywa około 38 000 takich wywołań.
Doładowania przyjmują dowolną kwotę całkowitą od $20 do $500, z +5% od $50, +10% od $100 i +15% od $200. Możesz zapłacić kryptowalutami (USDT na TRC20, USDC na Base). Kredyt nigdy nie wygasa, a nieudane lub odrzucone zapytania nie są rozliczane. Szczegóły na stronie z cenami.
Lista kontrolna migracji
Jeśli przenosisz aplikację, która już rozmawia z DeepSeek, przejdź przez te kroki w kolejności. Każdy krok zajmuje kilka minut.
- Umieść trzy wartości w konfiguracji. Base URL, klucz i nazwa modelu powinny pochodzić ze zmiennych środowiskowych, a nie ze stałych rozrzuconych w kodzie.
- Uruchom test dymny. Jedno chat completion, jedno strumieniowane completion, jedno wywołanie w trybie JSON i jedno wywołanie narzędzia. Powyższe cztery fragmenty je pokrywają.
- Odtwórz prawdziwe prompty. Pobierz 30 promptów ze swoich logów i porównaj odpowiedzi obok siebie. Oceniaj je według własnych kryteriów, a nie ogólnego wyniku.
- Obsłuż 429. Dodaj ponowne próbowanie z backoff i respektuj
Retry-After. Strumieniowane zapytanie zajmuje slot równoległości do końca strumienia, więc zamykaj porzucone strumienie. - Śledź koszt. Loguj
usagez każdej odpowiedzi i porównuj go z nagłówkiemX-Balance-USDprzez dzień ruchu. - Wdrażaj stopniowo. Najpierw wyślij 5 do 10 procent ruchu na nowy endpoint, a następnie zwiększ go.
Porównaj koszt na zadanie, a nie cenę za token, ponieważ różne modele używają różnych liczb tokenów do tego samego zadania. Dla otwartego sprawdzenia, jak zachowują się modele pisania bez ograniczeń, opis roleplay jest przydatnym uzupełnieniem.
Wybór między nimi
Użyj własnego API DeepSeek, gdy konkretnie potrzebujesz modelu DeepSeek, jego funkcji dostawcy lub oficjalnego wsparcia. Użyj tego endpointa, gdy chcesz hostowanego modelu kompatybilnego z OpenAI, który odpowiada bez odrzuceń treści dla prawnego użytku przez osoby pełnoletnie, z prostym rozliczeniem przedpłaconym i promptami, które nie są używane do trenowania. Wiele zespołów będzie potrzebować obu za przełącznikiem konfiguracji, co ułatwia wspólny protokół. Materiały referencyjne dla tego API znajdują się w dokumentacji.
Więcej przewodników
Pytania i odpowiedzi
Czy to oficjalne API DeepSeek?
Nie. To niezależny endpoint kompatybilny z OpenAI obsługujący jeden model o otwartych wagach pod ID uncensored. Nie jest to usługa DeepSeek i nie przekierowuje do niej.
Czy mogę ponownie użyć kodu DeepSeek?
Jeśli korzysta z SDK OpenAI lub formatu completion czatu, zwykle tak. Zmień bazowy URL, klucz i nazwę modelu, a następnie przetestuj swoje prompty.
Gdzie znajdę nazwę modelu?
Wywołaj GET /v1/models. To API obsługuje jeden model o ID uncensored.
Jak duże jest okno kontekstu?
100 000 tokenów dla promptu i uzupełnienia.
Token Bearer w nagłówku Authorization
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.