Getting started with the API
Il-konfigurazzjoni tal-aċċess għall-API tibda bil-ħolqien ta’ kont tal-iżviluppatur fuq il-pjattaforma DeepSeek u l-ġenerazzjoni tal-ewwel API key mit-taqsima tal-kredenzjali. Il-proċess ta’ quickstart jinvolvi tliet passi fundamentali: il-konfigurazzjoni tal-awtentikazzjoni, l-installazzjoni tal-SDK, u l-eżekuzzjoni tal-ewwel talba tiegħek. Il-biċċa l-kbira tal-iżviluppaturi ilestu l-ittestjar tal-ewwel talba fi żmien 15-il minuta billi użaw il-mudelli tal-kodiċi pprovduti.
L-awtentikazzjoni tuża l-format ta’ bearer token b’ċwievet li jibdew bil-prefiss sk-. Il-URL bażi għall-endpoints kollha tal-API huwa https://api.deepseek.com/v1, skont il-konvenzjonijiet RESTful. Header meħtieġ jinkludi l-Authorization bl-API key tiegħek u l-Content-Type issettjat bħala application/json. Ir-rate limiting japplika għal kull ċavetta u mhux għal kull kont, u b’hekk it-timijiet jistgħu jqassmu l-kwoti na l-proġetti differenti.
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)
Għal dawk li jippreferu t-talbiet curl, l-ekwivalenti tal-waħda HTTP teħtieġ konfigurazzjoni espliċita tal-header. Dan il-metodu huwa utli għall-ittestjar mingħajr dipendenzi fuq l-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
}'
L-API tirritorna JSON responses li fihom it-test iġġenerat, statistika tal-użu tat-tokens, u metadata tat-talba. Risposti ta’ suċċess jinkludu array ta’ choices bl-output tal-mudell, filwaqt li l-iżbalji jirritornaw kodiċijiet standardizzati għal debugging aktar faċli. L-għadd tat-tokens jidher fl-oġġett tal-usage, li jsegwi prompt_tokens, completion_tokens, u total_tokens għal kontijiet preċiżi.
- Akkwist tal-API key setup mit-tab tas-sigurtà fid-dashboard tal-iżviluppatur.
- Installazzjoni tal-Python SDK jew użu ta’ HTTP requests diretti għal flessibilità lingwistika.
- Ittestjar tal-konnettività b’chat completion sempliċi qabel l-integrazzjoni finali.
- Monitoraġġ tal-headers tar-rispons għall-istat tar-rate limit u l-kwota li fadal.
