DeepSeek API: Teljes Útmutató az AI Integrációhoz

Az API használatának megkezdése

Az API-hozzáférés beállítása a DeepSeek platformon történő fejlesztői fiók létrehozásával és az első API kulcs generálásával kezdődik a hitelesítő adatok menüpontban. A gyorsindítási folyamat három alapvető lépésből áll: a hitelesítés konfigurálásából, az SDK telepítéséből og az első lekérdezés végrehajtásából. A legtöbb fejlesztő 15 percen belül sikeresen teszteli az első kérést a biztosított kódsablonok segítségével.

A hitelesítés bearer token formátumot használ, ahol a kulcsok "sk-" előtaggal rendelkeznek. Minden API végpont alap URL-je a https://api.deepseek.com/v1, követve a RESTful konvenciókat. A kötelező fejlécek közé tartozik az Authorization a saját API kulccsal, valamint a Content-Type application/json értékkel. A sebességkorlátozás kulcsonként, nem pedig fiókonként érvényes, ami lehetővé teszi a csapatok számára a kvóták elosztását a projektek között.

A Python SDK telepítéséhez használja a pip csomagkezelőt a hivatalos kliens könyvtár hozzáadásához. Az alábbi kód egy teljes első kérést mutat be a chat completion végponton keresztül, a DeepSeek V3 modell használatával:

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": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    max_tokens=500,
    temperature=0.7
)

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

A curl parancsot preferáló fejlesztők számára az ekvivalens HTTP hívás explicit fejléc-konfigurációt igényel. Ez a megközelítés ideális SDK függőségek nélküli teszteléshez:

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": "Hello, API!"}],
    "max_tokens": 100
  }'

Az API JSON válaszokat ad vissza, amelyek tartalmazzák a generált szöveget, a tokenhasználati statisztikákat és a kérés metaadatait. A sikeres válaszok egy choices tömböt tartalmaznak a modell kimenetével, míg a hibák szabványos kódokat küldenek a hibakereséshez. A tokenszámok a usage objektumban jelennek meg, követve a prompt_tokens, completion_tokens és total_tokens értékeket a számlázási pontosság érdekében.

• Szerezze be az API kulcsot a fejlesztői dashboard biztonsági füléről.
• Telepítse a Python SDK-t vagy használjon közvetlen HTTP kéréseket.
• Tesztelje a kapcsolatot egy egyszerű chat completion hívással az élesítés előtt.
• Kövesse figyelemmel a válaszfejléceket a sebességkorlátok és a maradék kvóta ellenőrzéséhez.

A dokumentációban található gyorsindítási útmutatók további nyelveket is lefednek, beleértve a Node.js és Go környezeteket, keretrendszer-specifikus példákkal az Express, Flask és FastAPI integrációkhoz. Az aszinkron feldolgozáshoz szükséges webhook konfigurációk a kezdeti beállítás során végpont-ellenőrzést igényelnek.