DeepSeek api开放平台控制台旁证图 — 旁证图：控制台用于密钥、用量与文档入口。

HELP / 步骤向导

DeepSeek api开放平台帮助

按步骤整理密钥获取、接口调用、参数与计费、错误排查，以及 DeepSeek Harness 评测复现。表格中的参数名称写进单元格，不使用图片代替文字。

API KEY

开放平台接入从密钥开始

密钥相当于程序访问凭证。不要把完整密钥写入网页、公开仓库、截图或聊天记录。

进入控制台

确认需要的是开发者控制台，而不是 DeepSeek网页版入口。

完成账户设置

按平台当前规则完成登录、验证和必要的账户配置。

创建密钥

按项目或环境分别创建，记录用途，不在多人之间共用。

写入环境变量

由服务端读取，避免硬编码在前端与源代码中。

REQUEST / RESPONSE

接口调用的最小结构

以下为本地占位示例，展示请求由地址、请求头与消息体组成。部署前应按 DeepSeek api开放平台当前文档替换具体值。

DeepSeek接口调用请求结构旁证图 — 旁证图：接口调用由目标地址、凭证与消息体三部分组成。

request.py

import os
import json
import urllib.request

payload = {
  "model": "YOUR_MODEL",
  "messages": [
    {"role": "user", "content": "拆解这个问题"}
  ]
}

request = urllib.request.Request(
  "YOUR_API_ENDPOINT",
  data=json.dumps(payload).encode("utf-8"),
  headers={
    "Authorization": "Bearer " + os.environ["DEEPSEEK_API_KEY"],
    "Content-Type": "application/json"
  }
)

示例不包含真实密钥，也不把不确定的当前端点写死。请以开放平台当前文档为准。

PARAMETERS

请求参数说明

参数名称与取值范围写在表格单元格里，便于检索与复制。

常用请求参数
参数名称	所在位置	作用	使用提醒
Authorization	请求头	携带 Bearer 与密钥完成鉴权	不要写入前端代码
Content-Type	请求头	声明请求体为 application/json	缺失会被拒绝解析
model	请求体	指定本次调用使用的模型标识	不同任务可选不同模型
messages	请求体	角色与内容组成的上下文	控制历史长度以节省输入
temperature	请求体	影响输出随机性	评测时应固定以便复现
max_tokens	请求体	限制本次生成的最大长度	避免输出被意外截断

TOKEN & COST

理解 Token 计费口径

DeepSeek API价格怎么算，关键不只看单价，还要区分输入、输出、缓存与请求规模；最终费用以开放平台当前计费页为准。

INPUT

输入 Token

包含提示词、系统说明与历史上下文。删除重复背景并按任务截取材料可明显降低规模。

OUTPUT

输出 Token

模型生成的回答内容。设置明确格式和长度上限，避免不必要的长篇输出。

RETRY

失败重试

超时或限流后的再次请求会累计用量。应使用指数退避并设置最大重试次数。

ERROR TERMS

常见错误按层排查

先判断鉴权、限流还是服务端异常，再决定修复配置、等待重试或缩小请求。

错误码与处理顺序
状态类别	常见原因	先做什么	复核点
401 鉴权失败	密钥缺失、过期或请求头格式错误	检查环境变量是否读取到正确密钥	密钥未被写入日志
429 请求限流	并发过高或短时间内重试过多	降低并发并加入退避与抖动	重试次数是否设上限
5xx 服务异常	服务端暂时不可用	记录时间后等待重试	是否保留追踪信息
超时	请求体过大或网络不稳定	拆分任务并缩短上下文	是否设置超时上限

HARNESS

让模型评测能够复现

DeepSeek Harness 在这里指一套固定样本、提示、参数与评分口径的评测方法，而不是只看一次回答好不好。

DeepSeek Harness 评测复现流程旁证图 — 旁证图：评测由测试集、运行配置、指标与复核记录共同组成。

保存测试集版本，并记录样本来源与适用范围。
固定系统提示、用户提示、模型标识与关键参数。
同时记录正确率、格式合规率、响应时间与人工复核意见。
区分回归测试与探索测试，不用同一组结论替代全部场景。
保留失败样本，复测时确认问题是否真正修复。

DeepSeek Harness 测试结果记录旁证图 — 旁证图：结果需要回到具体样本和参数，不能只保留总分。

evaluation.json

{
  "dataset": "qa-set-v1",
  "prompt_version": "p3",
  "model": "YOUR_MODEL",
  "temperature": 0,
  "metrics": [
    "accuracy",
    "format_pass_rate",
    "latency_ms"
  ]
}

SAFETY & PRIVACY

上线前的安全检查

开放世界不等于开放凭证。进入生产环境前应明确数据边界、访问权限与日志保留策略。

密钥与权限

按项目隔离密钥，设置最小权限与轮换机制；发现泄露后立即撤销，不等待自然过期。

数据与复核

敏感信息先脱敏，关键结论由人工确认；日志避免记录完整密钥和不必要的个人信息。