DeepSeek API: Efektívna integrácia veľkých jazykových modelov

Ako začať s rozhraním API

Nastavenie prístupu k rozhraniu sa začína vytvorením účtu na platforme DeepSeek a vygenerovaním prvého API kľúča v sekcii poverení. Proces rýchleho spustenia zahŕňa tri hlavné kroky a to konfiguráciu overenia, inštaláciu SDK a vykonanie prvej požiadavky. Väčšina vývojárov dokončí testovanie prvej požiadavky do 15 minút s využitím poskytnutých šablón kódu.

Autentifikácia využíva formát bearer tokenu, pričom kľúče majú predponu sk-. Základná URL adresa pre všetky koncové body je https://api.deepseek.com/v1 a riadi sa konvenciami RESTful. Povinné hlavičky zahŕňajú Authorization s vaším API kľúčom a Content-Type nastavený na application/json. Limity sa uplatňujú na úrovni kľúča, nie účtu, čo tímom umožňuje rozdeliť kvóty medzi viaceré projekty.

Pre inštaláciu SDK pre Python použite správcu balíkov pip na pridanie oficiálnej klientskej knižnice. Nasledujúci kód demonštruje kompletný pracovný postup prvej požiadavky with využitím koncového bodu pre chat pomocou modelu 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": "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)

Pre vývojárov preferujúcich nástroj curl vyžaduje ekvivalentné volanie HTTP explicitnú konfiguráciu hlavičiek. Tento prístup je ideálny na testovanie bez nutnosti inštalácie dodatočných závislostí 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": "Hello, API!"}],
    "max_tokens": 100
  }'

Rozhranie API vracia odpovede vo formáte JSON obsahujúce vygenerovaný text, štatistiky používania tokenov a metadáta požiadavky. Úspešné odpovede obsahujú pole choices s výstupom modelu, zatiaľ čo chyby vracajú štandardizované kódy na uľahčenie ladenia. Počty tokenov sa zobrazujú v objekte usage a sledujú prompt_tokens, completion_tokens aj total_tokens pre presnú fakturáciu.

• Získanie nastavenia API kľúča v zabezpečení na paneli vývojára.
• Inštalácia Python SDK alebo použitie priamych HTTP požiadaviek pre flexibilitu.
• Testovanie konektivity pomocou jednoduchého dopytu pred plnou integráciou do produkcie.
• Monitorovanie hlavičiek odpovedí na zisťovanie stavu limitov a zostávajúcej kvóty.

Príručky v dokumentácii pokrývajú aj ďalšie jazyky vrátane Node.js a Go s príkladmi pre rámce Express, Flask a FastAPI. Konfigurácie webhookov pre asynchrónne procesy vyžadujú overenie koncového bodu počas úvodného nastavenia.