01
可检索
字段名与取值以文本形式写入单元格，不依赖图片识别。
DeepSeek api开放平台
字段、错误码与评测口径都写在表格里
DeepSeek api开放平台的字段名、取值与错误码处理动作以表格文本呈现，可被检索与复制。DeepSeek AI 的回答结构在网页版与接口里保持一致；DeepSeek Harness 按轮次留痕，DeepSeek - 探索未至之境 的每一步都能事后复查。
ENTRY A / 网页版
开始使用 / 网页体验
一次性问题用 DeepSeek网页版入口更省事，不需要配置密钥。
进入网页版 →ENTRY B / 开放平台
接入 DeepSeek api开放平台
重复执行的批量任务走接口，字段固定、返回结构化、错误码可读。
选择开始方式 →WHY / 为什么写在表格里
为什么把字段写进表格
写在图片里查不到、也改不动；写在单元格里可检索、可复制、可对照。
02
可对照
请求与响应字段分表列出，类型与默认值逐行对齐。
03
可判断
错误码对应处理动作用文本写明，脚本读到就知道怎么走。
04
可复查
DeepSeek Harness 按轮次留痕，结论标注已验证或待确认。
WHAT / 四类接入场景
四类接入场景
左为文案说明，右为四个场景的详情。四类场景共用同一套字段，只是取值不同。
DeepSeek AI 在网页版与接口里口径一致：先问条件，再给判断，最后标注未验证项。
批量改写
同一提示词跑多条内容，用 temperature 控制稳定度。
日志排查
把报错原文放进 messages，配合 stream 逐段接收。
表格核对
两列数据一起提交，返回差异行号与字段名，便于落库。
定时归纳
固定 model 与提示词，按计划触发，输出进入下一环节前先核验。
HOW / 三步开始
三步开始
先在网页版跑通一轮，再换成接口调用，最后按错误码处理异常。
1
跑通一次
在 DeepSeek网页版入口确认提示词可用，再谈自动化。
2
换成调用
把提示词搬进 messages，填 model、max_tokens 与 stream。
3
处理异常
按返回码分派：401 查密钥，422 查字段，429 退避，500 记现场。
FIELD / 字段表
请求字段表
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| api_key | string | 是 | 调用凭证，放在请求头，不写进请求体 |
| model | string | 是 | 模型标识，固定取值以官网文档为准 |
| messages | array | 是 | 对话数组，每项含 role 与 content |
| temperature | number | 否 | 取值 0–2，值越低输出越稳定 |
| max_tokens | integer | 否 | 单次返回的上限，超出会被截断 |
| stream | boolean | 否 | true 时逐段返回，适合长输出 |
| 状态码 | 含义 | 处理动作 |
|---|---|---|
| 401 | 凭证无效或过期 | 检查 api_key 是否放入请求头，重新签发后重试 |
| 422 | 字段缺失或取值越界 | 对照字段表补字段，检查 temperature 与 max_tokens 取值 |
| 429 | 触发限流 | 按返回的等待时间退避重试，避免并发突增 |
| 500 | 服务端异常 | 记录请求现场后间隔重试，连续失败则暂停任务 |
POST /v1/chat/completions
Authorization: Bearer {api_key}
{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "条件：…；输出：…"}],
"temperature": 0.3,
"max_tokens": 1024,
"stream": false
}
EVAL / 评测口径
三轮核验口径
| 轮次 | 判据 | 通过标准 |
|---|---|---|
| 第一轮 | 现象能否复现 | 按给定步骤可稳定复现 |
| 第二轮 | 原因是否命中 | 给出的原因与实际成因一致 |
| 第三轮 | 修正是否可用 | 按修正方案执行后现象消失 |
DeepSeek Harness 保存每一轮的输入、输出与改动原因；未通过第三轮的结论一律记为待确认，不写入最终结果。
CHANGELOG / 更新动态
更新动态
字段、错误码与评测口径的变更记录，按时间从近到远排列。
2026.10 · 字段
字段表补齐默认值说明
temperature、max_tokens、stream 的默认值与取值区间写入表格。
2026.09 · 错误码
429 返回等待时间
限流返回带上建议等待时间，脚本可按该值退避。
2026.08 · 评测
三轮核验口径公开
复现、命中、可用三轮分开判，未通过不计入命中。
NOTES / 用户反馈
用户反馈
错误码能直接判断
422 和 429 分开写之后，脚本不用猜该重试还是该改参数。
后端工程师 · 杭州
留痕能复盘
DeepSeek Harness 把每轮改动原因留下来，出问题时能查到依据。
平台工程师 · 成都
待确认不混进结论
没过第三轮的结果单列出来，评测数据可信很多。
数据工程师 · 广州
FAQ / 常见问题
常见问题
DeepSeek api开放平台的密钥放在哪里？
放在请求头的 Authorization 字段里，键名为 api_key，不要写进请求体或前端代码。
返回 422 通常是什么原因？
多为字段缺失或取值越界：检查 messages 是否为空，以及 temperature 是否在 0–2、max_tokens 是否为正整数。
Deep Seek 与 DeepSeek AI 有区别吗？
指向同一套能力，Deep Seek 多为手写或口播时的写法；DeepSeek AI 是正式名称，接口与入口一致。
网页版入口和接口该选哪个？
一次性问题用 DeepSeek网页版入口更省事；需要每天重复执行的任务用 DeepSeek api开放平台。
结论里标注「待确认」代表什么？
代表未通过第三轮核验，只是候选原因。DeepSeek - 探索未至之境 的做法是如实留白，不把推测写成结论。
