API QUICKSTART

DeepSeek api开放平台接入指南

DeepSeek 开放平台接口设计全面兼容 OpenAI 协议。开发者无需学习新的通信规范，仅需调整端点 Base URL 与请求头中的密钥，即可完成对 DeepSeek-V3 与 DeepSeek-R1 (128K 长上下文长模型) 的无缝调用。

Python SDK 调用示例 (兼容 openai-python)

# 安装依赖: pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-deepseek-api-key",
    base_url="help.html#api-v1"  # 官方接入端点
)

response = client.chat.completions.create(
    model="deepseek-reasoner",  # 支持 deepseek-chat 或 deepseek-reasoner (R1)
    messages=[
        {"role": "system", "content": "你是由深度求索研发的科研智能体"},
        {"role": "user", "content": "针对 128K 超长上下文构建数学思维链推导"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

PRICING TIERS

API 接口调用与计费价格 (Token 梯次)

为降低学术研究与生产工程调用成本，DeepSeek 坚持普惠定价策略。支持精确至个位 Token 计费，无额外接入年费或保底消费门槛。

模型规格标识	支持上下文窗口	输入价格 (1M Tokens)	输出价格 (1M Tokens)	缓存命中优惠
deepseek-chat (V3)	128K Context	¥ 1.00	¥ 2.00	¥ 0.20 (降 80%)
deepseek-reasoner (R1)	128K Context	¥ 4.00	¥ 16.00	¥ 1.00 (降 75%)

* 注：新注册开发者账号默认获赠 500 万体验 Token 额度，支持控制台实时生成、销毁与重置多组子密钥。

BENCHMARK TOOLKIT

DeepSeek Harness 自动化评测套件

DeepSeek Harness 是官方开源的大模型统一基准评测运行框架。支持一键复现官方学术论文所公示的各项指标，包括 GSM8K、MATH-500、MMLU-Pro、HumanEval 以及 128K 长上下文多跳检索评估。

# 克隆官方 Harness 评测仓库并初始化环境
git clone help.html#harness-repo
cd deepseek-harness && pip install -e .

# 运行 128K 长上下文多跳检索基准评测任务
python run_eval.py \
  --model deepseek-reasoner \
  --tasks needle_in_a_haystack,math_500 \
  --num_fewshot 0 \
  --batch_size 16 \
  --output_path ./eval_results.json

HARDWARE REQUIREMENTS

DeepSeek 本地部署与 Ollama 硬件要求

针对企业局域网或个人开发者私有化离线运行需求，官方提供全尺寸开源模型权重，可无缝导入 Ollama 框架运行。

模型蒸馏/量化版本	最低内存 / 显存	推荐运行设备	一键运行指令
DeepSeek-R1-Distill-1.5B	4 GB RAM / VRAM	入门笔记本 / 手机端侧	`ollama run deepseek-r1:1.5b`
DeepSeek-R1-Distill-7B/8B	8 GB RAM / VRAM	RTX 3060 / Apple M1+	`ollama run deepseek-r1:8b`
DeepSeek-R1-Distill-14B	16 GB VRAM	RTX 4070 / Apple M2 (24G)	`ollama run deepseek-r1:14b`
DeepSeek-R1-Distill-32B	24 GB VRAM	RTX 4090 / 2×RTX 3090	`ollama run deepseek-r1:32b`
DeepSeek-R1 全尺寸 (671B MoE)	多卡并发 (约 380GB+)	8×H800 / 8×A100 集群	`vllm serve deepseek-ai/DeepSeek-R1`

DOC FAQ

开放平台开发者常见排错

遇到 API 调用报 429 速率限制、401 密钥失效或超时等情况，请核对以下指引：

429 频率超限： 默认免费账户限制 60 RPM（每分钟请求数），如需扩充并发可在控制台提交用量工单秒级审核。
超长上下文超时： 处理超过 64K 上下文时，建议显式开启 stream=True 流式传输模式以维持长连接活跃状态。
数学思维链获取： 调用 deepseek-reasoner 时，思考过程字段包含在 reasoning_content 结构体中，请确保 SDK 为最新版本。