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

DeepSeek 帮助中心 人工智能 API 开放平台接入指南

作为新一代官方人工智能在线站技术门户,提供全面兼容业界标准的流式接口调用体系。通过独创 64-Token 自动前缀缓存引擎,将长上下文重复调用的延迟与资费压缩至极限,并开源统一双盲测试沙箱规程,参数与阶梯指标在文字表格单元格中清晰列明。

API_SANDBOX_TOPOLOGY // V3.2 REST_JSON_SCHEMA
DeepSeek API 开放平台接口架构与调度图
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、SGLang、Ollama 等流行开源推理框架,企业可以在多台私有 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 秒内自动恢复。请开启客户端自动重试机制以确保平稳。