PL ▾
Pobierz klucz API

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ć.

Zaktualizowano

Dwa pasujące złącza połączone świecącymi się blokami kodu, pokazujące wymianę API
Dwie wieże monet o różnej wysokości podłączone do małego serwera, pokazujące ceny tokenów wejściowych i wyjściowych

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.

PytanieDokumentacja DeepSeekTo API
Bazowy URLDokumentacja w szybkim starcie (api.deepseek.com)https://api.deepseek4api.com/v1
AutoryzacjaToken Bearer w nagłówku AuthorizationToken Bearer w nagłówku Authorization
Nazwa modeluWymienione w dokumentacji modeli; sprawdź aktualne nazwyuncensored
Główny endpointUzupełnianie czatuChat completions, Responses, lista modeli
CennikSprawdź 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_limited lub concurrency.
  • Saldo. Sprawdź kredyt za pomocą GET /v1/balance, routingu grantów kredytowych w stylu OpenAI lub nagłówka X-Balance-USD w 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.

  1. 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.
  2. 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ą.
  3. 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.
  4. 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.
  5. Śledź koszt. Loguj usage z każdej odpowiedzi i porównuj go z nagłówkiem X-Balance-USD przez dzień ruchu.
  6. 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.

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.