Przejdź do głównej treści

Wprowadzenie

DeepSeek to usługa czatu AI oferowana przez Ace Data Cloud, oparta na serii dużych modeli językowych DeepSeek. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować DeepSeek w Pythonie, realizując funkcje takie jak wieloetapowa rozmowa, systemowe promptowanie, strumieniowe wyjście, tryb wyjścia JSON oraz głębokie wnioskowanie.

Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

Podstawowe użycie

Główny endpoint API DeepSeek to:
POST https://api.acedata.cloud/deepseek/chat/completions
W tym przykładzie używamy modelu deepseek-r1. Dostępne modele to: deepseek-r1, deepseek-r1-0528, deepseek-v3, deepseek-v3-250324. Pełny przykład kodu w Python:
import requests

url = "https://api.acedata.cloud/deepseek/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "deepseek-r1",
    "messages": [
        {
            "role": "user",
            "content": "你好,请介绍一下你自己"
        }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP:
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

Zaawansowane użycie

Dla API czatu obsługiwane jest strumieniowe wyjście, umożliwiające odbiór odpowiedzi w czasie rzeczywistym:
import requests

data['stream'] = True
response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode())

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieautoryzowany, sprawdź token API
403Brak środków lub brak dostępu
429Przekroczona częstotliwość zapytań
500Błąd wewnętrzny serwera

Kolejne kroki