DEVELOPER PORTAL // 接口文档与技术指南
DeepSeek 帮助中心 人工智能 API 开放平台接入指南
作为新一代官方人工智能在线站技术门户,提供全面兼容业界标准的流式接口调用体系。通过独创 64-Token 自动前缀缓存引擎,将长上下文重复调用的延迟与资费压缩至极限,并开源统一双盲测试沙箱规程,参数与阶梯指标在文字表格单元格中清晰列明。
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 |
HARNESS // DUAL BLIND
DeepSeek Harness 离线双盲沙箱评测规程
为彻底解决大模型刷榜与训练数据污染问题,DeepSeek 开源了统一的离线验证沙箱:
01. 离线网络封锁与环境隔离
所有测试题目的解答完全在物理禁网的独立沙箱内执行,杜绝通过在线搜索拉取现成解法的可能。
02. 执行级单元测试断言判分
代码评测任务必须通过完备边界条件的测试断言,数理推理题目需转化为代数符号树进行等价性校验。
03. 零样本与少样本双盲打分
对所有输入展开自动化同态置换扰动,检验模型真正掌握长思维链逻辑推演而非记忆套路。
OFFLINE // PRIVATE CLOUD
企业级局域网与端侧完全离线部署
针对核心商业机密、金融合规或离线工业环境,全系列权重开放免费商用授权,支持无缝迁移至内网专属集群。
通过 vLLM、SGLang、Ollama 等流行开源推理框架,企业可以在多台私有 GPU 服务器上快速拉起兼容 OpenAI 规范的局域网私有端点,实现百分之百数据驻留与内网合规闭环。
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 秒内自动恢复。请开启客户端自动重试机制以确保平稳。