DEVELOPER HUB // 接口文档与技术指南
DeepSeek 帮助中心 API开放平台与对话接入指南
提供 DeepSeek 与 Deep Seek 通用对话接口规范。全面兼容行业通用调用协议,独创 64-Token 自动前缀缓存引擎,支持以极低资费调用 128,000 上下文推理节点,后文深入展开 DeepSeek Harness 离线双盲沙箱复现规程。
INTEGRATION // CODE SNIPPETS
快速接入:5 分钟完成推理端点对接
PYTHON // OPENAI_SDK_COMPATIBLE
main.py
# 兼容标准 OpenAI SDK,仅需替换 base_url 与 api_key
from openai import OpenAI
client = OpenAI(
api_key="sk-deepseek-official-key",
base_url="https://api.deepseek.com"
)
response = client.chat.completions.create(
model="deepseek-reasoner", # 调用 R1 显式思维链
messages=[
{"role": "user", "content": "求解非齐次常微分方程并给出严谨证明"}
],
stream=True
)
for chunk in response:
if chunk.choices[0].delta.reasoning_content:
print(chunk.choices[0].delta.reasoning_content, end="")
CURL // RAW_HTTP_REQUEST
terminal_call.sh
# 使用 cURL 发送原生 HTTP POST 请求
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-deepseek-official-key" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "你是一位资深架构师"},
{"role": "user", "content": "请对比分布式事务中 2PC 与 Saga 模式的容错边界"}
],
"stream": false,
"temperature": 0.6
}'
PRICING // CACHE ALIGNED
64-Token 自动前缀缓存与透明资费矩阵
| 模型型号 | 上下文长度 | 输入未命中缓存价格 | 输入命中缓存价格 (省90%) | 输出 Tokens 价格 |
|---|---|---|---|---|
| DeepSeek-R1 (推理旗舰) | 128,000 Tokens | ¥0.14 / 百万 Tokens | ¥0.014 / 百万 Tokens | ¥2.19 / 百万 Tokens |
| DeepSeek-V3 (通用底座) | 128,000 Tokens | ¥0.14 / 百万 Tokens | ¥0.014 / 百万 Tokens | ¥0.28 / 百万 Tokens |
| DeepSeek-Coder / Math | 128,000 Tokens | ¥0.14 / 百万 Tokens | ¥0.014 / 百万 Tokens | ¥0.28 / 百万 Tokens |
API METRICS // SLA GUARANTEE
高并发接口可用性与计费指标
99.8%
全球多可用区双活集群高可用 SLA 保障
¥0.014
每百万 Tokens 缓存命中输入最低资费
128K
原生超长上下文跨文档依赖无损分析
60+ QPS
默认企业账户峰值弹性吞吐并发支持
HARNESS // DUAL BLIND
DeepSeek Harness 离线双盲沙箱评测规程
为了彻底解决大语言模型刷榜训练数据污染问题,深度求索开源了统一的离线验证框架:
01. 离线网络封锁与环境隔离
所有测试题目的解答完全在物理禁网的独立沙箱内执行,严格杜绝通过在线搜索获取既有题解的可能性。
02. 执行级单元测试断言判分
代码评测任务必须通过包含边界条件的真实测试用例,数理推理题目需转化为代数符号树进行等价性校验。
03. 零样本与少样本双盲打分
对所有输入进行自动化扰动与同义符号替换,验证模型真正具备长思维链推理能力而非模板拟合。
OFFLINE // PRIVATE CLOUD
企业级局域网与端侧完全离线部署
针对核心商业机密、金融合规或离线作业环境,全系列权重开放免费商用授权,支持无缝迁移至内网专属集群。
通过社区广泛支持的开源推理服务器(如 vLLM、Ollama、LMDeploy、SGLang),企业可以在私有 GPU 服务器上快速拉起兼容通用接口规范的局域网私有端点,实现百分之百数据驻留与内网合规闭环。
TROUBLESHOOTING // HTTP CODES
API 常见状态码与快速排障速查表
401 Unauthorized // 认证失效
API Key 错误或未授权
检查请求头中 Authorization: Bearer 后是否正确包含有效的 API Key,确认密钥未被重置或被系统停用。
429 Rate Limit // 请求限频
并发请求数或 TPM 超限
单账户当前并发数超出设定配额,建议在代码中引入指数退避重试策略,或在控制台申请提升 QPS 上限。
400 Bad Request // 参数不合法
输入超长或 JSON 格式错误
输入 Tokens 超过 128,000 上下文上限,或 messages 数组为空。请使用官方分词器校验输入序列长度。
503 Service Unavailable // 节点负载过载
服务节点临时弹性调度中
集群正在应对极端并发峰值扩容,通常在 1-2 秒内自动恢复。请开启客户端自动重试机制以确保平稳过渡。