DeepSeek 标志 DeepSeek OFFICIAL
窄颈工法 // 工程手册

DeepSeek api开放平台帮助手册

如同把沙粒约束在精密口径内平稳落下，工程接入追求规范、透明与可复验。以下提供从 Key 申领到流式输出的完整工步。

01 · 申请与保护 API Key

登录 DeepSeek api开放平台 后进入「API Keys」面板创建新令牌，创建时复制并牢固存储：

  • 环境隔离：通过环境变量 export DEEPSEEK_API_KEY="sk-..." 挂载，切勿直接写死并推送至公开仓库。
  • 最小权限：按团队功能模块拆分子 Key，若遇密钥泄露可在控制台随时作废。
  • 网页版免 Key：若仅个人在浏览器与移动端交互，直接使用网页版即可，无需消耗 API 额度。
DeepSeek api开放平台控制台管理界面

02 · DeepSeek API 怎么调用？

接口全面兼容 OpenAI 协议。无论使用 cURL、Python 还是 Node.js，只需重定向 Base URL：

curl https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-reasoner",
    "messages": [
      {"role": "user", "content": "比对两份采购协议在违约金上限上的差异，给出具体条款位置。"}
    ],
    "stream": false
  }'

若使用官方 OpenAI Python SDK，只需配置 base_url="https://api.deepseek.com"。R1 推理模型的深度思考内容会包含在返回消息的 reasoning_content 字段中。

03 · DeepSeek API 价格透明核算

全量采用按百万 tokens 消耗结算模式。支持长上下文自动缓存（Prompt Caching），重复前缀享受大幅折扣：

模型代号 缓存命中输入 全新输入 生成输出
deepseek-chat (V3) ¥0.14 ¥2.00 ¥8.00
deepseek-reasoner (R1) ¥1.00 ¥4.00 ¥16.00
DeepSeek API 账单计费与用量监控面板

04 · DeepSeek 本地部署教程

对于数据涉密或需严苛内网物理隔离的机构，可拉取官方开源蒸馏模型在自建算力节点运行：

  1. 评估显存选型：7B 尺寸可在 16GB 显存显卡顺畅微调；32B/70B 推荐选用双卡或四卡轻量级服务器。
  2. 一键载入推理引擎：使用 Ollama 执行 ollama run deepseek-r1:7b 或通过 vLLM 高并发框架装载 GGUF / AWQ 权重。
  3. 输出一致性校验：以 Harness 官方题库为基准对照私有化输出，保障本地版保持 R1 核心逻辑推演能力。

05 · DeepSeek Harness 基准评测

Harness 评测库是沙漏刻度的检定仪。通过标准化数据集固定评分，杜绝主观臆测： 

# 启动官方评估套件
git clone <repo> && cd harness
pip install -r requirements.txt
python run_suite.py --model deepseek-reasoner --suite math-500 --seed 42

评测通过后将生成包含每道错题思考链细节的结构化 JSON 报告，便于针对性调整 System Prompt。