Arendaja platvorm

DeepSeek API

DeepSeek ülevaade arendajatele, mis hõlmab API-juurdepääsu, hinnastust, SDK-tuge, lõppunkte, võimekusi ja platvormi reegleid.

Dokumentatsioon API juhend

API võti Nõutud

Peamine API OpenAI-ga ühilduvad Responses API ja Chat Completions API

SDK tugi Ametlikes näidetes kasutatakse DeepSeeki baasaadressiga konfigureeritud OpenAI Pythoni ja JavaScripti SDK-sid. Dokumenteeritud on ka Anthropicuga ühilduvad integratsioonid. PHP puhul saab kasutada otse HTTP-päringuid; ametlikku DeepSeeki PHP SDK-d ei õnne

Päringupiirangud Dokumenteeritud kontotaseme samaaegsete päringute limiit on deepseek-flashi puhul 2500 ja deepseek-v4-pro puhul 500. Samaaegsuspiiri ületamisel tagastatakse HTTP 429. DeepSeek dokumenteerib ka päringute ühenduse avatuna hoidmise käitumise ning kümneminuti

Platvorm

API ülevaade

Lõppunktid (endpoints)

API ligipääs

Juuraadress (Base URL)


					https://api.deepseek.com

Peamine API OpenAI-ga ühilduvad Responses API ja Chat Completions API

Hinnad

API Hinnad

Hinnakujundusmudel Kasutuspõhine tokenihinnastus eraldi vahemällu salvestatud sisendi, vahemällu salvestamata sisendi ja väljundi tariifidega; kehtivad tipptunni- ja tipptunnivälised hinnad.

deepseek-flash: 0,003–0,006 dollarit vahemällu salvestatud sisendi, 0,15–0,30 dollarit vahemällu salvestamata sisendi ja 0,60–1,20 dollarit väljundi eest 1 miljoni tokeni kohta. deepseek-v4-pro: 0,022–0,044 dollarit vahemällu salvestatud sisendi, 0,66–1,32 dollarit vahemällu salvestamata sisendi ja 1,98–3,96 dollarit väljundi eest 1 miljoni tokeni kohta.

Arendaja töömugavus

SDK info

SDK Ametlikes näidetes kasutatakse DeepSeeki baasaadressiga konfigureeritud OpenAI Pythoni ja JavaScripti SDK-sid. Dokumenteeritud on ka Anthropicuga ühilduvad integratsioonid. PHP puhul saab kasutada otse HTTP-päringuid; ametlikku DeepSeeki PHP SDK-d ei õnne

Kasutusmugavus Kõrge nende arendajate jaoks, kes tunnevad OpenAI-ga ühilduvaid API-sid. Platvorm kasutab standardset HTTP-d, Beareri autentimist, JSON-päringuid ning ühilduvate Pythoni ja JavaScripti SDK-de seadistust.

Dokumentatsioon Hea ja aktiivselt ajakohastatav dokumentatsioon, mis sisaldab API viitelehti, kiirjuhendeid, funktsioonijuhendeid, hinnainfot, veakoode, failide ja visiooni dokumentatsiooni, Responses API ning agentide integreerimise dokumentatsiooni.

Viivitus Kindlat latentsuse SLA-d ega garanteeritud reageerimisaja näitajat ei õnnestunud kinnitada. Latentsus sõltub mudelist, koormusest, päringu suurusest, arutluse põhjalikkusest ning tipptunni- ja tipptunnivälisest ajastusest. Pikalt kestvad päringud võivad j

Allikad

Viited arendajale

Dokumentatsioon ↗ API juhend ↗ Liivakast ↗

Featuurid

API võimekused

✓ Voogedastus

✓ Funktsioonide kasutamine

✓ Assistants API

✓ Failide üleslaadimine

✓ Pildi sisend

✓ Liivakast

Lühikirjeldus

Praegune API-platvorm toetab Chat Completionsit, Responsesit, Anthropicuga ühilduvaid Messages-sõnumeid, voogedastust, funktsioonide ja tööriistade kutsumist, JSON-väljundit, arutlusprotsessi juhtelemente, kasutajate isoleerimist välja user_id alusel ning pildisisendit deepseek-flashi kaudu. Responses API toetab semantilisi SSE-sündmusi ja funktsioonikutsete väljundiüksusi. Files API toetab kuni 64 MiB suuruste JPEG-, PNG-, GIF- ja WebP-failide üleslaadimist. Failidele saab soovi korral määrata aegumise ühe tunni kuni kolmekümne päeva pärast või säilitada need püsivalt, kui aegumist ei määrata. Mudelil deepseek-flash on 1 miljoni märgi suurune kontekstiaken ja see toetab visiooni; deepseek-v4-pro on loetletud visiooni mittetoetavana. DeepSeek Harnessi kirjeldatakse esimese osapoole arendajate eelvaate agentide raamistikuna. Eraldi dokumenteeritud skeemipiirangutega Structured Outputs funktsiooni ega avalikku peenhäälestuse API-t ei õnnestunud kinnitada. Pärandnimed deepseek-v4-flash ja deepseek-v4-flash-vision-exp on endiselt aktsepteeritud, kuid need on kasutuselt kõrvaldatud aliased, mida teenindab praegune Flashi mudel.

Näited

API Näited

export DEEPSEEK_API_KEY="sk-your-key"

curl --fail-with-body https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain what an API timeout is in one sentence."}
    ],
    "thinking": {"type": "disabled"},
    "stream": false
  }' | jq -r '.choices[0].message.content'

# Streaming with JSON Output
curl --fail-with-body https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "system", "content": "Return valid JSON with keys answer and confidence."},
      {"role": "user", "content": "Summarize why retries need backoff."}
    ],
    "response_format": {"type": "json_object"},
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

# Install: pip install -U openai
import json
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Give me three names for a weather app."},
    ],
    thinking={"type": "disabled"},
)
print(response.choices[0].message.content)

# Structured JSON output
json_response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Return valid JSON with keys title and tags."},
        {"role": "user", "content": "Describe a secure API gateway."},
    ],
    response_format={"type": "json_object"},
)
print(json.loads(json_response.choices[0].message.content))

# Streaming
stream = client.responses.create(
    model="deepseek-flash",
    instructions="Answer clearly and briefly.",
    input="What is exponential backoff?",
    stream=True,
)
for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
print()

# Uploaded image file for vision input
with open("image.jpg", "rb") as image_file:
    uploaded = client.files.create(file=image_file, purpose="user_data")
vision_response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe this image."},
            {"type": "file", "file_id": uploaded.id},
        ],
    }],
)
print(vision_response.choices[0].message.content)

// Install: npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: "https://api.deepseek.com",
});

const response = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Give me three names for a weather app." },
  ],
  thinking: { type: "disabled" },
});
console.log(response.choices[0].message.content);

// Streaming through the Responses API
const stream = await client.responses.create({
  model: "deepseek-flash",
  instructions: "Answer briefly and clearly.",
  input: "Explain why API clients use timeouts.",
  stream: true,
});
for await (const event of stream) {
  if (event.type === "response.output_text.delta") {
    process.stdout.write(event.delta);
  }
}
process.stdout.write("\n");

// Tool calling
const toolResponse = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "What is the weather in Boston?" }],
  tools: [{
    type: "function",
    function: {
      name: "get_weather",
      description: "Get current weather for a city.",
      parameters: {
        type: "object",
        properties: { city: { type: "string" } },
        required: ["city"],
      },
    },
  }],
});
const toolCall = toolResponse.choices[0].message.tool_calls?.[0];
if (toolCall) {
  console.log(JSON.parse(toolCall.function.arguments));
} else {
  console.log(toolResponse.choices[0].message.content);
}

<?php
$apiKey = getenv('DEEPSEEK_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('DEEPSEEK_API_KEY is not set');
}

$url = 'https://api.deepseek.com/chat/completions';
$payload = [
    'model' => 'deepseek-flash',
    'messages' => [
        ['role' => 'system', 'content' => 'You are a helpful assistant.'],
        ['role' => 'user', 'content' => 'Explain what an API timeout is in one sentence.'],
    ],
    'thinking' => ['type' => 'disabled'],
    'stream' => false,
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_TIMEOUT => 120,
]);

$body = curl_exec($ch);
if ($body === false) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException('cURL error: ' . $error);
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($status < 200 || $status >= 300) {
    $message = $data['error']['message'] ?? $body;
    throw new RuntimeException('DeepSeek API error (' . $status . '): ' . $message);
}

$content = $data['choices'][0]['message']['content'] ?? null;
if ($content === null) {
    throw new RuntimeException('No assistant content was returned');
}
echo $content . PHP_EOL;
?>

Põhimõtted

Andmete kasutus

Avalikult kättesaadavast dokumentatsioonist ei leidnud kinnitust, et API-de puhul kehtiks selgelt määratletud vaikeseade, mille kohaselt andmeid treenimiseks ei kasutata. DeepSeeki avalikus privaatsuspoliitikas on märgitud, et DeepSeeki kontserni kuuluvad üksused võivad töödelda isikuandmeid teadus- ja arendustegevuseks, alusmudelite treenimiseks ja optimeerimiseks, analüüsiks ning muudel seotud eesmärkidel. Kuna poliitika käsitleb DeepSeeki teenuseid ega erista selgelt majutatud API-de andmekontrolle, peaksid organisatsioonid tutvuma kohaldatavate avatud platvormi tingimustega ning vältima tundlike andmete edastamist, välja arvatud juhul, kui nende privaatsus- ja turvameeskonnad on selle heaks kiitnud.

Andmete säilitamine

Avalikus privaatsuspoliitikas on sätestatud, et säilitamisperiood sõltub isikuandmete hulgast, liigist, tundlikkusest, kasutuseesmärgist ja nendega seotud õiguslikest nõuetest ning et andmeid võidakse säilitada ja töödelda Hiinas. Files API puhul võidakse üles laaditud pilte säilitada tähtajatult, kui aegumisväljad jäetakse määramata, või määrata nende säilitamisajaks 3 600 kuni 2 592 000 sekundit. Universaalse API-päringute säilitamisperioodi kohta ei õnnestunud kinnitust leida.

Päringupiirangud

Dokumenteeritud kontotaseme samaaegsete päringute limiit on deepseek-flashi puhul 2500 ja deepseek-v4-pro puhul 500. Samaaegsuspiiri ületamisel tagastatakse HTTP 429. DeepSeek dokumenteerib ka päringute ühenduse avatuna hoidmise käitumise ning kümneminuti

Arendaja juhend

DeepSeek API: praegune arendajaplatvorm, mudelid, hinnad ja integratsioonijuhend

DeepSeek pakub aadressil api.deepseek.com kasutuspõhise hinnastusega OpenAI-ga ühilduvat arendaja-API-t. Arendajad saavad kasutada Chat Completionsi, Responses API-t, Anthropicuga ühilduvat Messagesi liidest, Files API-t, voogedastust, tööriistakutseid, JSON-väljundit ja nägemissisendit mudeli deepseek-flash kaudu. Praegused peamised mudelitunnused on deepseek-flash ja deepseek-v4-pro.

DeepSeeki arendajaplatvorm võimaldab rakendustel saata standardsete HTTP API-de kaudu viipasid, pilte ja tööriistajuhiseid DeepSeeki hostitud mudelitele. See on mõeldud arendajatele, kes soovivad OpenAI-ga ühilduvaid integratsioonimustreid, kasutuspõhist hinnastamist, arutlus- ja kodeerimisvõimekust ning juurdepääsu pildisisendile, ilma et nad peaksid kasutusele võtma teenusepakkuja spetsiifilise programmeerimiskeele. Juhendis käsitletakse juurdepääsu, mudeli valikut, päringuid, vastuseid, hinnastamist, võimalusi, SDK-sid, piiranguid ja tootmiskeskkonnaga seotud kaalutlusi.

DeepSeeki arendajaplatvorm pakub OpenAI-ga ühilduvaid Chat Completionsi ja Responsesi API-sid, Anthropicuga ühilduvat liidest, piltide üleslaadimist, voogedastust, tööriistade kutsumist, JSON-väljundit ning kasutuspõhist hinnastust mudelitele DeepSeek Flash ja V4 Pro.

Mis on DeepSeek API ja millal seda kasutada?

DeepSeek API on hostitud arendajaplatvorm, mille abil saab DeepSeeki mudelite võimalused lisada rakendustesse, kodeerimistööriistadesse, agentidesse ja automatiseeritud töövoogudesse. Selle peamine lõpp-punkt on https://api.deepseek.com. Platvorm järgib OpenAI-ga ühilduvaid tavasid, mistõttu saavad OpenAI klienditeekide või standardsete JSON-i HTTP-päringutega tuttavad arendajad sellega tavaliselt kiiresti kohaneda.

Praegu pakub platvorm Chat Completionsi, Responses API-t, Anthropicuga ühilduvat Messages-liidest ja Files API-t. API toetab teksti genereerimist, arutlusvõimet, koodi, voogedastatavaid vastuseid, funktsiooni- või tööriistakutseid, JSON-väljundit ning piltide mõistmist deepseek-flash kaudu.

DeepSeek on mõistlik valik, kui vajate konkurentsivõimelist tokenipõhist hinnastust, OpenAI-ga ühilduvaid liideseid, tugevat arutlus- ja kodeerimisvõimekust, hiina keele tuge või Flash-mudeli kaudu piltide sisendi töötlemist. See ei pruugi sobida, kui teie rakendus vajab kontrollitud API-spetsiifilist treenimisest loobumise vaikeseadet, universaalset viipade säilitamise garantiid, küpset pildi- või videogenereerimist või teenusepakkujast sõltumatut andmetöötluse asukohta.

Kuidas saada juurdepääs ja luua API-võti?

Juurdepääs API-le on eraldi tasuta tarbijatele mõeldud DeepSeek Webi ja rakenduse teenustest. Looge DeepSeek Platformil konto, looge API-võti ja lisage API kasutamiseks vajaduse korral kontole raha. Iga API-päring peab sisaldama võtit Beareri märgina.

Hoidke võtit oma serveris või saladuste halduris. Ärge lisage seda brauseri JavaScripti, mobiilirakenduse binaarfailidesse, lähtekoodirepositooriumidesse ega kliendipoolsetesse logidesse. Tüüpiline päring kasutab järgmisi päiseid:

Authorization: Bearer $DEEPSEEK_API_KEY
Content-Type: application/json

Platvorm pakub ka arendajate mänguvälja aadressil platform.deepseek.com. Kasutage seda konto juurdepääsu kontrollimiseks ja katsetamiseks enne päringute rakendusse lisamist.

Millise API ja mudeli peaksite valima?

Enamiku uute integratsioonide puhul tuleb valida OpenAI-ga ühilduva Chat Completions API ja Responses API vahel. Chat Completions on lihtsam valik vestluspäringute ja olemasolevate OpenAI-laadsete integratsioonide jaoks. Responses sobib paremini semantiliste voosündmuste, vastuseüksuste ja agendilaadsete töövoogude jaoks.

DeepSeek pakub ka Anthropicuga ühilduvat Messages-liidest aadressil https://api.deepseek.com/anthropic. See võib vähendada üleminekuga seotud tööd rakendustes, mis on juba üles ehitatud Anthropic-formaadis päringutele.

Mudel	Hea lähtekoht	Nägemisvõimekus	Dokumenteeritud samaaegsus
`deepseek-flash`	Kulutundlikud üldised töökoormused, kodeerimine, arutlus ja piltide sisend	Jah	2 500
`deepseek-v4-pro`	Nõudlikum arutlus või agenditöövood, kus hind on vähem oluline	Ei	500

deepseek-flash on DeepSeek-V4.1-Flashi praegune identifikaator. Vanemad V4 Flashi identifikaatorid võivad endiselt kasutusel olla aegunud aliaste kujul, kuid uued rakendused peaksid kasutama praegust identifikaatorit. deepseek-v4-pro on tekstikeskne ega toeta praegu piltide sisendit.

Tehke oma esimene päring

Järgmine näide kasutab Chat Completionsi. Enne käivitamist määrake API-võti keskkonnas:

export DEEPSEEK_API_KEY="sk-your-key"

curl --fail-with-body https://api.deepseek.com/chat/completions 
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain what an API timeout is in one sentence."}
    ],
    "thinking": {"type": "disabled"},
    "stream": false
  }'

Tavaline päring saadab mudeli nime ja sõnumite massiivi. Süsteemisõnum määrab üldise käitumise, kasutajasõnum sisaldab aga ülesannet. Seade thinking juhib selles päringus arutlusrežiimi; näites on see lühikese vastuse saamiseks keelatud.

Sama päring OpenAI Pythoni SDK-ga

DeepSeeki dokumenteeritud kiirkäivitused kasutavad OpenAI SDK-d, mis on seadistatud DeepSeeki baas-URL-iga:

# Install: pip install -U openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Give me three names for a weather app."},
    ],
    thinking={"type": "disabled"},
)

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

Kuidas vastusest aru saada?

Chat Completions tagastab vastuseobjekti, mis sisaldab üht või mitut valikut. Lihtsa voogedastuseta päringu korral on genereeritud tekst tavaliselt saadaval aadressil response.choices[0].message.content. Vastus sisaldab ka kasutusteavet, mida saab kasutada kulude jälgimiseks.

Kui taotletakse tööriistu, võib assistendi sõnum sisaldada tavalise teksti asemel tööriistakutseid. Teie rakendus peab kutset kontrollima, selle argumendid valideerima, vastava kohaliku funktsiooni või teenuse käivitama ja saatma tööriista tulemuse mudelile tagasi. Ärge kunagi käivitage genereeritud argumente ilma valideerimiseta.

Responses API kasutab ainult vestlussõnumite asemel vastuseüksusi. Selle voosündmused sisaldavad muu hulgas nimesid nagu response.output_text.delta ning funktsioonikutsed on esitatud väljundiüksustena. See vorming on kasulik siis, kui rakendus vajab semantilist sündmuste käsitlemist või agentidele suunatud töövooge.

Kuidas DeepSeek API hinnastamine toimib?

DeepSeek võtab tasu tokenikasutuse, mitte fikseeritud igakuise arendajapaketi alusel. Hinnad on esitatud miljoni tokeni kohta ning eristatakse vahemällu salvestatud sisendit, vahemällu salvestamata sisendit ja väljundit. Kehtivad ka tipptunni- ja tipptunnivälised hinnad. Dokumenteeritud vahemikud on järgmised:

Mudel	Vahemällu salvestatud sisend	Vahemällu salvestamata sisend	Väljund
`deepseek-flash`	$0.003–$0.006 1 miljoni tokeni kohta	$0.15–$0.30 1 miljoni tokeni kohta	$0.60–$1.20 1 miljoni tokeni kohta
`deepseek-v4-pro`	$0.022–$0.044 1 miljoni tokeni kohta	$0.66–$1.32 1 miljoni tokeni kohta	$1.98–$3.96 1 miljoni tokeni kohta

Tipptunnid on esmaspäevast reedeni kell 01:00–04:00 ja 06:00–10:00 UTC. Iga vahemiku alumine hind tähistab tipptunnivälist hinda. Pidage ametlikku hinnalehte kõige usaldusväärsemaks allikaks, sest hinnad võivad muutuda. DeepSeek võtab tasu konto saldolt, kasutades juhul, kui mõlemad on saadaval, esmalt antud saldot ja seejärel kontole lisatud raha.

Mida saavad arendajad API abil luua?

Väljundi voogedastus

Vooedastus saadab genereeritud väljundi järk-järgult, selle asemel et oodata kogu vastuse valmimist. Chat Completions kasutab serveri saadetud sündmusi ja lõpeb tähisega data: [DONE]. Responses API kasutab semantilisi sündmusi, näiteks response.output_text.delta, ning viimase sündmusena lõpetatud, lõpetamata või nurjunud vastuse sündmust.

Voogedastus on kasulik vestlusliideste ja pikkade vastuste puhul, kuid rakendus vajab endiselt ühenduse ajalõppe, veakäsitlust ja viisi lõpetamata väljundi käsitlemiseks.

Funktsiooni- ja tööriistakutsed

Mõlemad loetletud mudelid toetavad tööriistakutseid. Määrake funktsioon koos selle nime, kirjelduse ja parameetrite skeemiga. Mudel võib funktsiooni välja kutsuda, kuid selle käivitab teie rakendus, mitte DeepSeek. Pärast käivitamist saatke tulemus mudelile tagasi, et see saaks koostada lõpliku vastuse.

Enne genereeritud kutse käivitamist valideerige nimed, tüübid, vahemikud, õigused ja autoriseerimine. DeepSeeki dokumentatsioon märgib, et genereeritud argumendid ei pruugi alati deklareeritud skeemile täpselt vastata.

JSON-väljund

DeepSeek toetab JSON-väljundit funktsiooniga response_format: {"type":"json_object"}. Öelge mudelile selgelt, et see peab tagastama JSON-i, ja kirjeldage viibas eeldatavat struktuuri:

json_response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "Return valid JSON with keys title and tags."},
        {"role": "user", "content": "Describe a secure API gateway."},
    ],
    response_format={"type": "json_object"},
)

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

See annab korrektse JSON-väljundi, kuid ei ole sama mis eraldi kontrollitud skeemipiirangutega Structured Outputsi funktsioon. Parsige ja valideerige tagastatud JSON oma rakenduses.

Nägemisvõimekus ja üleslaaditud failid

deepseek-flash võtab vastu pilte avalike URL-ide, base64-andme-URL-ide või üleslaaditud failidena. Files API toetab kuni 64 MiB suuruseid JPEG-, PNG-, GIF- ja WebP-pilte. Üleslaaditud failid seotakse API-võtmega, mille abil need loodi.

Faile võidakse säilitada püsivalt, kui aegumist ei määrata, või määrata nende aegumiseks üks tund kuni kolmkümmend päeva. Kasutage aegumisseadeid läbimõeldult, eriti tundliku materjali käsitlemisel. Avalik dokumentatsioon ei kehtesta universaalset API-põhist viipade säilitamise perioodi.

Täiustatud integratsiooninäited

Voogedastus Responses API-ga

stream = client.responses.create(
    model="deepseek-flash",
    instructions="Answer clearly and briefly.",
    input="What is exponential backoff?",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
print()

Kasutage seda lähenemist, kui rakendus vajab semantilisi vastusesündmusi, mitte ainult Chat Completionsi järkjärgulisi delta-väärtusi.

Üleslaaditud pildile viitamine

with open("image.jpg", "rb") as image_file:
    uploaded = client.files.create(file=image_file, purpose="user_data")

vision_response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe this image."},
            {"type": "file", "file_id": uploaded.id},
        ],
    }],
)

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

SDK-d ja keelte tugi

Pythoni ning JavaScripti või TypeScripti rakendused saavad kasutada praeguseid OpenAI klienditeeke koos DeepSeeki baas-URL-iga. Anthropicuga ühilduvad integratsioonid saavad kasutada Messages-liidest. PHP-rakendused saavad API-le helistada tavalise HTTPS-i ja cURL-i abil; esitatud dokumentatsiooni põhjal ei õnnestunud ametlikku DeepSeeki PHP SDK-d kontrollida.

Piirangud ja tootmiskeskkonna kaalutlused

Dokumenteeritud kontotaseme samaaegsus on praegu deepseek-flash puhul 2 500 ja deepseek-v4-pro puhul 500. Kohaldatava samaaegsuspiiri ületamine võib tagastada HTTP 429.

Muud dokumenteeritud olekukoodid on 400 vigaste vormingute, 401 autentimisvigade, 402 ebapiisava saldo, 422 vigaste parameetrite, 500 serverivigade ja 503 ülekoormuse korral. DeepSeek dokumenteerib kümneminutilise piirangu päringutele, mille puhul järeldamine pole alanud, ning pikaajaliste päringute puhul ühenduse elushoidmise käitumise.

Tootmiskeskkonna kliendid peaksid:

Määrama ühenduse ja lugemise jaoks selged ajalõpud.
Proovima ajutiste 429-, 500- ja 503-vigade korral uuesti eksponentsiaalse viivitusega.
Mitte proovima autentimis- või parameetrivigade korral uuesti enne päringu muutmist.
Jälgima konto saldot, tokenikasutust, vastusevigu ja samaaegsust.
Jätma API-võtmed ja tundlikud viibad logidest välja.
Valideerima tööriistaargumendid ja JSON-vastused enne nende kasutamist.
Kontrollima üleslaaditud sisu failide aegumise ja kustutamise käitumist.

Privaatsus ja andmete käsitlemine

DeepSeeki avalikus privaatsusmaterjalis öeldakse, et andmeid võidakse säilitada ja töödelda Hiina Rahvavabariigis. Materjalis kirjeldatakse säilitamist sõltuvana sellistest teguritest nagu andmete tüüp, tundlikkus, eesmärk ja õiguslikud nõuded. Uuritud materjalid ei paku selgelt dokumenteeritud API-spetsiifilist treenimisest loobumise vaikeseadet ega universaalset API säilitamisperioodi.

Organisatsioonid peaksid enne isikuandmete, konfidentsiaalse, reguleeritud või varalise teabe saatmist tutvuma kohaldatavate platvormi tingimuste ja privaatsusdokumentatsiooniga. Kui teie nõuded eeldavad kindlat andmete asukoha poliitikat, lepingulist säilitamisperioodi või API-viipade puhul kinnitatud treenimisest loobumist, kontrollige need meetmed enne juurutamist otse üle.

Eelised ja piirangud

Millal DeepSeek API sobib?

Rakendused, mis saavad kasu OpenAI-ga ühilduvatest Chat Completionsi või Responsesi liidestest.
Kulutundlikud töökoormused, mille puhul saab kasutada dokumenteeritud Flashi hinnastust.
Kodeerimise, arutluse, matemaatika, hiina keele ja üldise teksti rakendused.
Agenditöövood, mis vajavad tööriista- või funktsioonikutseid või Responses API sündmusi.
Rakendused, mis vajavad piltide mõistmist deepseek-flash kaudu.
Meeskonnad, kes tunnevad end standardse HTTP või ühilduvate Pythoni ja JavaScripti SDK-de kasutamisel kindlalt.

Millal see ei pruugi sobida?

Rakendused, mis vajavad piltide või videote genereerimist või laia tarbijatele mõeldud pluginate ökosüsteemi.
Töökoormused, mis vajavad Pro-mudeli nägemisvõimekust.
Organisatsioonid, kes ei saa lubada andmete töötlemist või säilitamist Hiinas.
Süsteemid, mis vajavad selgelt dokumenteeritud API-spetsiifilist treenimisest loobumise vaikeseadet või universaalset säilitamisgarantiid.
Rakendused, mis vajavad eraldi kontrollitud skeemipiirangutega Structured Outputsi funktsiooni.
Suure mahuga süsteemid, mis ei saa arvestada dokumenteeritud samaaegsuspiirangute või teenuse koormuse kõikumisega.

Praktiline lähtekoht

Looge DeepSeek Platformi konto ja API-võti.
Alustage deepseek-flash-ga tavaliste teksti-, kodeerimis-, arutlus- või nägemisvõimekuse testide jaoks.
Kasutage lihtsa päringu puhul Chat Completionsi ning Responsesi siis, kui vajate semantilist voogedastust või agendilaadseid töövooge.
Salvestage tokenikasutus ning testige nii tipptunni kui ka tipptunnivälise hinna eeldusi.
Lisage enne tootmiskasutust ajalõpud, eksponentsiaalse viivitusega korduspäringud, saldo jälgimine ja vastuste valideerimine.
Enne tegelike kasutaja- või äriandmete saatmist vaadake üle privaatsuse, säilitamise ja andmete asukoha nõuded.

Allikad 14