DeepSeek API: Ghid Complet de Integrare și Modele AI

Getting started with the API

Configurarea accesului la API începe cu crearea unui cont de dezvoltator pe platforma DeepSeek și generarea primei chei API din secțiunea de acreditări. Procesul de pornire rapidă implică trei pași de bază: configurarea autentificării, instalarea SDK-ului și executarea primei cereri. Majoritatea dezvoltatorilor finalizează testarea primei cereri în 15 minute folosind șabloanele de cod furnizate.

Autentificarea utilizează formatul bearer token cu chei prefixate de "sk-". URL-ul de bază pentru toate endpoint-urile API este https://api.deepseek.com/v1, respectând convențiile RESTful. Header-ele obligatorii includ Authorization cu cheia API și Content-Type setat la application/json. Limitarea ratei se aplică pe cheie și nu pe cont, permițând echipelor să distribuie cotele pe mai multe proiecte.

Pentru instalarea SDK-ului Python, utilizați pip pentru a adăuga biblioteca client oficială. Următorul cod demonstrează un flux complet pentru prima cerere folosind endpoint-ul de chat completion cu 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)

Pentru dezvoltatorii care preferă cereri prin curl, apelul HTTP echivalent necesită configurarea explicită a header-elor. Această abordare funcționează pentru testare fără dependențe de 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
  }'

API returnează răspunsuri JSON care conțin textul generat, statistici privind utilizarea token-urilor și metadate despre cerere. Răspunsurile reușite includ o matrice choices cu rezultatul modelului, în timp ce erorile returnează coduri standardizate pentru depanare. Numărul de tokens apare în obiectul usage, monitorizând prompt_tokens, completion_tokens și total_tokens pentru acuratețea facturării.

• Obțineți configurarea cheii API din fila de securitate a tabloului de bord.
• Instalați SDK-ul Python sau utilizați cereri HTTP directe pentru flexibilitate.
• Testați conectivitatea cu o finalizare simplă de chat înainte de integrarea în producție.
• Monitorizați header-ele de răspuns pentru starea limitei de rată și cota rămasă.

Ghidurile de pornire rapidă din documentație acoperă limbi suplimentare, inclusiv Node.js și Go, cu exemple specifice pentru integrări în Express, Flask și FastAPI. Configurarea webhooks pentru procesarea asincronă necesită verificarea endpoint-ului în timpul configurării inițiale.