DEVELOPER PORTAL // 接口文档与技术指南

DeepSeek 帮助中心 API 开放平台与结构接入指南

提供 DeepSeek api开放平台 标准规范与接入文档:求索更深,结构更清楚。全面兼容通用接口协议,独创 64-Token 前缀缓存阶梯定价体系,配以 DeepSeek Harness 离线双盲沙箱复现指南,助力开发者与企业以极高性价比稳定接入。

API_SANDBOX_TOPOLOGY // V3.2 REST_JSON_SCHEMA
DeepSeek API 开放平台接口架构与调度图
HELP INDEX // 帮助中心目录
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
DeepSeek Harness 离线评测沙箱流程图
HARNESS // DUAL BLIND

DeepSeek Harness 离线双盲沙箱评测规程

为了彻底解决大语言模型刷榜训练数据污染问题,DeepSeek 开源了统一的离线验证框架:

01. 离线网络封锁与环境隔离

所有测试题目的解答完全在物理禁网的独立沙箱内执行,严格杜绝通过在线搜索获取既有题解的可能性。

02. 执行级单元测试断言判分

代码评测任务必须通过包含边界条件的真实测试用例,数理推理题目需转化为代数符号树进行等价性校验。

03. 零样本与少样本双盲打分

对所有输入进行自动化扰动与同义符号替换,验证模型真正具备长思维链推理能力而非模板拟合。

OFFLINE // PRIVATE CLOUD

企业级局域网与端侧完全离线部署

针对核心商业机密、金融合规或离线作业环境,全系列权重开放免费商用授权,支持无缝迁移至内网专属集群。

通过社区广泛支持的开源推理服务器(如 vLLM、Ollama、LMDeploy、SGLang),企业可以在私有 GPU 服务器上快速拉起兼容 OpenAI 规范的私有端点,实现百分之百数据驻留与内网合规闭环。

DeepSeek 离线部署与安全隐私合规保障架构
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 秒内自动恢复。请开启客户端自动重试机制以确保平稳过渡。