Yfirlit yfir DeepSeek API

DeepSeek API veitir forritunaraðgang að úrvali stórra mállíkana frá DeepSeek í gegnum REST-viðmót sem er hannað fyrir hönnuði og fyrirtæki sem leita eftir hagkvæmri gervigreindarsamþættingu. Þjónustan styður mörg líkanaafbrigði sem eru fínstillt fyrir mismunandi verkefni, allt frá spjallgreind yfir í kóðun og innfelld (embeddings). Þetta viðmót viðheldur OpenAI-samhæfðum endapunktum, sem gerir hönnuðum kleift að skippta um þjónustuveitu með lágmarks breytingum á kóða.
Aðgangur að API krefst auðkenningar með „bearer“ lyklum sem búnir eru til í stjórnborði hönnuða. Opinber SDK eru í boði fyrir Python, Node.js, Go og Java, en hvaða HTTP-biðlari sem er getur átt samskipti við REST-endapunktana. Vettvangurinn miðar að einstökum hönnuðum sem byggja frumgerðir, sprotafyrirtækjum sem stækka gervigreindareiginleika sína og stórfyrirtækjum sem þurfa fyrirsjáanlegt verðlag fyrir mikið álag í ályktunarfasa (inference).
| Eiginleiki | Tæknilýsing |
|---|---|
| Aðgengileg líkön | DeepSeek V3, DeepSeek Coder V2, DeepSeek Chat |
| Hraðatakmarkanir | 500K tókenar á dag ókeypis, allt að 50M tókenar á dag í greiddri áskrift |
| Auðkenningaraðferð | Bearer tóken (API lykill) |
| Opinber SDK | Python, Node.js, Go, Java |
| Málstuðningur | Fjöltungumál (70+ tungumál, fínstillt fyrir EN/ZH) |
Helstu tæknilegir eiginleikar fela í sér streymisvörun fyrir rauntímaforrit, aðgerðaköll (function calling) fyrir samþættingu verkfæra og JSON-stilingu fyrir skipulögð úttaksgögn. API-viðmótið meðhöndlar samhengisglugga (context windows) allt að 128K tókena í flaggskiplíkönunum, sem gerir greiningu á löngum skjölum mögulega án hlutunar. Öllum beiðnum er beint í gegnum alþjóðleg CDN-kerfi með meðaltals biðtíma undir 200ms á flestum svæðum.
- REST API með OpenAI-samhæfðri uppbyggingu til að auðvelda flutning á milli kerfa.
- Innfæddur stuðningur við spjallúrvinnslu, innfellingar og kóðagerð.
- Sjálfvirk álagshjöfnun yfir klasa sem sjá um ályktunarfasa.
- Ítarlegar greiningar á notkun og rakning á eyðslu tókena.
Skjölun fyrir hönnuði inniheldur gagnvirk dæmi og stillingar fyrir „webhooks“ fyrir ósamfasa vinnslu. Samþætting tekur venjulega um 30 mínútur fyrir grunnútfærslu, með alhliða villumeðhöndlun og endurtökuferlum sem eru innbyggðir í opinber SDK.
Hvernig á að hefja notkun

Uppsetning á API-aðgangi hefst á því að búa til aðgang á DeepSeek-vettvangnum og búa til fyrsta API-lykilinn þinn í öryggishluta stjórnborðsins. Flýtiuppsetningin felur í sér þrjú meginþrep: stillingu auðkenningar, uppsetningu á SDK og keyrslu á fyrstu beiðninni. Flestir hönnuðir ljúka prófunum á fyrstu beiðni innan 15 mínútna með því að nota meðfylgjandi sniðmát.
Auðkenning notar bearer tóken snið þar sem lyklar byrja á „sk-“. Grunnslóðin (base URL) fyrir alla endapunkta er https://api.deepseek.com/v1 og fylgir hún RESTful stöðlum. Kröfð hausagögn (headers) fela í sér Authorization með API-lyklinum þínum og Content-Type stillt á application/json. Hraðatakmarkanir eiga við um hvern lykil frekar en hvern reikning, sem gerir teymum kleift að deila kvóta á milli margra verkefna.
Fyrir uppsetningu á Python SDK skal nota pip til að bæta við opinbera biðlarasafninu. Eftirfarandi kóði sýnir fullkomið vinnuflæði fyrir fyrstu beiðni með því að nota spjallendapunktinn með 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)
Fyrir hönnuði sem kjósa curl-beiðnir, þá krefst samsvarandi HTTP-kall sérstakra stillinga á hausum. Þessi nálgun virkar vel til að prófa án þess að treysta á SDK-pakka:
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-viðmótið skilar JSON-svörum sem innihalda myndaðan texta, tölfræði um notkun tókena og lýsigögn um beiðnina. Svör sem heppnast innihalda fylkið choices með úttaki líkansins, á meðan villur skila stöðluðum kóðum til villuleitar. Tókenafjöldi birtist í usage hlutnum, sem rekur prompt_tokens, completion_tokens og total_tokens fyrir nákvæma reikningagerð.
- Sæktu API-lykilinn þinn úr öryggisflipi stjórnborðs hönnuða.
- Settu upp Python SDK eða notaðu beinar HTTP-beiðnir fyrir sveigjanleika.
- Prófaðu tengingu með einfaldri spjallbeiðni fyrir raunverulega samþættingu.
- Fylgstu með svörunarhausum til að sjá stöðu hraðatakmarkana og eftirstöðvar kvóta.
Leiðbeiningar fyrir önnur tungumál eins og Node.js og Go eru aðgengileg í skjölunum, ásamt dæmum fyrir Express, Flask og FastAPI. Stillingar fyrir webhooks krefjast staðfestingar á endapunkti við fyrstu uppsetningu.
Líkön og endapunktar í boði

DeepSeek API býður upp á fimm framleiðslulíkön, hvert þeirra fínstillt fyrir ákveðna vinnu frá almennum samræðum til sérhæfðrar kóðagerðar. Val á líkani fer fram í gegnum model-breytuna í API-beiðnum, þar sem auðkenni fylgja mynstrinu „deepseek-{eiginleiki}-{útgáfa}“. Eldri líkön eru aðgengileg í 90 daga eftir að nýjar útgáfur koma út, og eru notendur upplýstir um slíkt tímanlega.
| Líkansauðkenni | Tegund | Samhengisgluggi | Bestu notkunartilfelli |
|---|---|---|---|
| deepseek-chat-v3 | Spjallúrvinnsla | 128K tókenar | Spjallgreind, almenn rökfærslu, fjöltungumál |
| deepseek-coder-v2 | Kóðagerð | 64K tókenar | Kóðasmíð, villuleit, tækniskjölun |
| deepseek-reasoner | Spjallúrvinnsla | 128K tókenar | Flókin verkefnalausn, rökfærslukeðjur |
| deepseek-embed | Innfellingar | 8K tókenar | Merkingarleit, RAG-vinnuflæði, líkindapörun |
| deepseek-vision-preview | Fjölsniða (Beta) | 32K tókenar + myndir | Myndgreining, OCR, spurningar úr myndum |
Endapunkturinn fyrir spjall á /v1/chat/completions sér um samræður með stuðningi við kerfisfyrirmæli (system prompts) og aðgerðaköll. Þessi endapunktur virkar bæði með deepseek-chat-v3 og deepseek-reasoner, en síðarnefnda líkanið bætir við rökfærsluferli í svörin. Stillingar eins og temperature og top_p stjórna slembiheitum í úttaki, á meðan max_tokens takmarkar lengd svarsins.
- Spjalllíkön styðja streymi í gegnum stream-breytuna fyrir betri notendaupplifun.
- Kóðalíkön innihalda sértækar bestanir fyrir Python, JavaScript, Java, C++ og Go.
- Líkanið fyrir innfellingar skilar 1024-vídda vigrum fyrir merkingarfræðilegar aðgerðir.
- Vision-líkanið tekur við vefslóðum mynda eða base64-kóðuðum gögnum ásamt texta.
Líkönin sem eru í boði spanna frá 7B til 671B stika, en notendur velja líkan efter getu frekar en stærð. DeepSeek Coder V2 skarar sérstaklega fram úr í HumanEval prófunum með 88.4% nákvæmni, á meðan flaggskipið V3 nær 87.1% í MMLU fyrir almenna þekkingu. Öll framleiðslulíkön styðja JSON-stillingu fyrir skipulögð gögn og samþættingu verkfæra.
Beta-líkön eins og deepseek-vision-preview geta sýnt meiri biðtíma á meðan þau eru í þróun. Listi yfir líkön á endapunktinum /v1/models sýnir núverandi framboð hverju sinni. Eldri líkön eins og deepseek-chat-v2 verða aðgengileg fram í mars 2026 til að tryggja samhæfni, en mælt er með að ný verkefni noti V3 fyrir hámarksafköst.
Notkunartilfelli og dæmi um samþættingu

Hagnýt dæmi um samþættingu API-viðmótsins spanna allt frá þjónustuspjallmennum til sjálfvirkni í innihaldsgerð og tæknilegra greininga. Þar sem viðmótið er OpenAI-samhæft er auðvelt að skipta út núverandi LLM-lausnum fyrir DeepSeek. Kerfi í raunnotkun nýta sér gjarnan streymi fyrir skjótari svörun og aðgerðaköll til að fá aðgang að utanaðkomandi gögnum.
Gerð spjallmenna er algengasta tegund samþættingar, þar sem fyrirtæki byggja gervigreind inn í þjónustugáttir og smáforrit. Samhengisglugginn upp á 128K tókena rúmar öll hjálparskjöl eða söguleg samskipti án þess að klippa þurfi af textanum. Aðgerðaköll gera spjallmönnum kleift að fletta upp í gagnagrunnum eða athuga stöðu pantana í rauntíma á meðan samtali stendur.
- Sjálfvirkt markaðsefni, bloggfærslur og vörulýsingar með stillanlegri sköpunargáfu.
- Kóðunaraðstoð sem samþættir DeepSeek Coder V2 í forritunarumhverfi fyrir sjálfvirka útfyllingu.
- Gagnagreining þar sem API-viðmótið vinnur úr rannsóknarskýrslum eða lagalegum skjölum.
- RAG-kerfi sem sameina DeepSeek Embeddings fyrir leit og spjalllíkön fyrir nákvæm svör.
Dæmigerð RAG-samþætting notar innfellingar til að vigra þekkingargrunn og geymir þá í vigurgagnagrunni eins og Pinecone. Þegar spurning kemur er viðeigandi upplýsingum flett upp og þær settar í samhengi við spjallfyrirmælin. Þessi tækni minnkar líkur á rangfærslum. JSON-stilling tryggir að úttakið sé á formi sem auðvelt er að lesa vélrænt, sem er nauðsynlegt fyrir sjálfvirk vinnuflæði.
Streymisvörun er lykilatriði fyrir notendaviðmót þar sem biðtími skiptir máli fyrir upplifunina. API-viðmótið sendir tókena jafnóðum í gegnum „server-sent events“, sem gerir viðmótum kleift að sýna texta á meðan hann verður til. Aðgerðaköll skilgreina fáanleg verkfæri með JSON-skema, sem leyfir líkaninu að ákveða hvenær þarf að grípa til utanaðkomandi aðgerða. Þessir eiginleikar gera kleift að búa til flókna gervigreindarfulltrúa sem leysa mörg verkefni í röð.
Algengar spurningar (FAQ)
Hvað kostar DeepSeek API?
Verðlagningin er mjög hagkvæm; til dæmis kostar 1 milljón inntakstókena fyrir DeepSeek V3 aðeins $0,27.
Er DeepSeek API samhæft við OpenAI?
Já, API-viðmótið notar sömu uppbyggingu og OpenAI, sem gerir það auðvelt að skipta um þjónustuveitu.
Hvaða forritunarmál eru studd?
DeepSeek býður upp á opinber SDK fyrir Python, Node.js, Go og Java.
Hversu stór er samhengisglugginn?
Flaggskiplíkön eins og V3 styðja allt að 128.000 tókena samhengisglugga.
Get ég fengið ókeypis inneign?
Já, nýir notendur fá venjulega $5 í ókeypis inneign við skráningu.
Styður API-viðmótið myndgreiningu?
Já, DeepSeek Vision líkanið er fáanlegt í beta-útgáfu fyrir myndvinnslu og OCR.
Hvar finn ég API-lykilinn minn?
Þú getur búið til og stjórnað API-lyklum í öryggisflipi stjórnborðs hönnuða.
Er hægt að streyma svörum?
Já, API styður rauntíma streymi (streaming) fyrir betri notendaupplifun.

