DeepSeek官网Shelf B · 为什么选它
排错这一排，先讲清四件事
字段、状态码、复现、核验各占一格。按格读，不用在整页里找。
字段先对齐
参数名与取值逐项列出，先确认写法，再看返回。
状态码能读
常见返回码与对应处理方式写成一张表，不用猜是哪一环出错。
复现有步骤
DeepSeek Harness 的复现分原样复跑与只改一个条件两种方式。
核验有依据
评测与核验步骤单独一列，结论落到可对照的字段上。
请求头放密钥
api_key 放请求头，不写在请求体里，避免随日志外泄。
上下文用数组
messages 用数组传多轮上下文，顺序即对话顺序。
可选字段可省
temperature、max_tokens 有默认值，不写也能跑。
报错先读码
返回非 200 时先看状态码表，再决定重试还是改参数。
| 参数名称 | 位置 | 是否必填 | 取值与默认值 |
|---|---|---|---|
| api_key | 请求头 | 必填 | 平台下发，无默认值 |
| model | 请求体 | 必填 | 按平台列出的模型名 |
| messages | 请求体 | 必填 | 数组，按对话顺序排列 |
| temperature | 请求体 | 可选 | 0 到 2，默认 1 |
| max_tokens | 请求体 | 可选 | 正整数，默认按模型上限 |
| stream | 请求体 | 可选 | true 或 false，默认 false |
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求体字段有误 | 对照字段表逐项检查 |
| 401 | api_key 无效 | 重新下发密钥后重试 |
| 429 | 请求过于频繁 | 退避后重试，降低并发 |
| 500 | 服务端异常 | 保留参数记录，稍后重试 |
| timeout | 响应超时 | 拆分请求或延长等待 |
Shelf D · 三步开始
三步开始
定路径、发请求、读码归档，三步走完再判断是否复现。
定路径
先在网页版跑一遍确认方向，再决定用 DeepSeek Harness 还是直接调接口。
发请求
api_key 放请求头，messages 用数组；可选字段先不写，用默认值跑通。
读码归档
记录状态码与参数；非 200 时按状态码表处理，再判断是否复现。
| 方式 | 改动范围 | 适用情况 |
|---|---|---|
| RUN 1 原样复跑 | 参数与条件全部不变 | 确认结论是否稳定 |
| RUN 2 只改一个条件 | 仅改动一个参数 | 定位差异落在哪个参数 |
Shelf E · 更新动态
最近改了什么
字段、状态码、复现三类的变化，按时间从上往下读。
字段表补默认值
temperature、max_tokens、stream 的默认值与可选范围逐项写明。
状态码表扩充
400、401、429、500、timeout 各自对应一条处理方式。
DeepSeek Harness 对照表上线
原样复跑与只改一个条件分开写，差异能定位到具体参数。
Shelf F · 用户反馈
看完的人怎么说
字段表把默认值写出来之后，第一次调接口就跑通了。
后端工程师 / 北京
状态码表很实用，遇到 429 知道先退避，不再盲目重试。
运维 / 广州
复现分两种方式之后，结论对不上时能定位到具体参数。
研究员 / 上海
Shelf G · 常见问题
常见问题
DeepSeek Harness 怎么复现一次结论
先把参数与条件记下来，再原样跑一遍（RUN 1）；要定位差异就只改一个条件（RUN 2）。两种方式见DeepSeek Harness 复现说明。
DeepSeek api开放平台怎么用
api_key 放请求头，model 与 messages 写在请求体，可选字段用默认值即可。逐项取值见开放平台字段说明。
返回 401 或 429 分别怎么处理
401 表示 api_key 无效，重新下发密钥；429 表示请求过密，退避后重试并降低并发。状态码表在字段与状态码一节。
评测与核验怎么做
固定输入、固定参数，两次结果逐项对照，差异记到参数上。步骤见评测与核验说明。
DeepSeek - 探索未至之境 指什么
它是这一排书架的总标题：未知问题先提出来，回答再一步步追到依据；DeepSeek - 探索未至之境 说的就是这个顺序，本页的复现与核验是最后一步。
Shelf H · 评测与核验
评测与核验说明
固定输入与参数，两次结果逐项对照；差异记到参数上，不靠印象判断。
| 轮次 | 输入 | 参数 | 核验点 |
|---|---|---|---|
| 第一轮 | 原始材料 | 默认参数 | 结论是否落在原文段落 |
| 第二轮 | 原始材料 | 与原样一致 | 两次结论是否一致 |
| 第三轮 | 原始材料 | 只改一个条件 | 差异是否落到该参数 |