DeepSeek API – Przewodnik po integracji, modelach i cenniku

Jak zacząć pracę z API

Konfiguracja dostępu do API rozpoczyna się od utworzenia konta programisty na platformie DeepSeek i wygenerowania pierwszego klucza API w sekcji poświadczeń. Proces szybkiego startu obejmuje trzy podstawowe kroki: konfigurację uwierzytelniania, instalację SDK oraz wykonanie pierwszego żądania. Większość programistów kończy testowanie pierwszego żądania w ciągu 15 minut, korzystając z dostarczonych szablonów kodu.

Uwierzytelnianie wykorzystuje format tokena nośnika z kluczami o prefiksie „sk-”. Podstawowy URL dla wszystkich punktów końcowych API to https://api.deepseek.com/v1, zgodnie z konwencjami RESTful. Wymagane nagłówki obejmują Authorization z kluczem API oraz Content-Type ustawiony na application/json. Limitowanie stawek dotyczy konkretnego klucza, a nie całego konta, co pozwala zespołom rozdzielać kwoty pomiędzy wiele projektów.

W przypadku instalacji SDK dla języka Python należy użyć menedżera pip, aby dodać oficjalną bibliotekę klienta. Poniższy kod demonstruje pełny przepływ pierwszego żądania przy użyciu punktu końcowego uzupełniania czatu z modelem DeepSeek V3:

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "Jesteś pomocnym asystentem."},
        {"role": "user", "content": "Wyjaśnij pojęcie obliczeń kwantowych w prostych słowach."}
    ],
    max_tokens=500,
    temperature=0.7
)

print(response.choices[0].message.content)

Dla programistów preferujących przykładowe żądania curl, równoważne wywołanie HTTP wymaga jawnej konfiguracji nagłówka. Takie podejście sprawdza się przy testowaniu bez zależności od SDK:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Witaj, API!"}],
    "max_tokens": 100
  }'

API zwraca odpowiedzi JSON zawierające wygenerowany tekst, statystyki użycia tokenów oraz metadane żądania. Pomyślne odpowiedzi zawierają tablicę choices z wynikiem modelu, podczas gdy błędy zwracają ustandaryzowane kody do celów debugowania. Liczba tokenów pojawia się w obiekcie usage, śledząc prompt_tokens, completion_tokens i total_tokens dla dokładności rozliczeń.

• Pobierz swój klucz API z zakładki bezpieczeństwa w panelu programisty.
• Zainstaluj Python SDK lub użyj bezpośrednich żądań HTTP dla elastyczności językowej.
• Przetestuj łączność za pomocą prostego uzupełniania czatu przed integracją produkcyjną.
• Monitoruj nagłówki odpowiedzi w celu sprawdzenia statusu limitów stawek i pozostałej kwoty.

Przewodniki szybkiego startu API w dokumentacji obejmują dodatkowe języki, w tym Node.js i Go, wraz z przykładami specyficznymi dla frameworków Express, Flask i FastAPI. Konfiguracje webhooków dla przetwarzania asynchronicznego wymagają weryfikacji punktu końcowego podczas wstępnej konfiguracji.