DeepSeek官网
图纸 H-01 · 帮助中心按任务顺序排布

DeepSeek 帮助中心

先在 DeepSeek网页版验证任务与输出格式,再进入 DeepSeek api开放平台完成接入;长任务交给 DeepSeek Harness 分步复现。搜索 Deep Seek 也能到达网页版入口。

网页版入口 先用网页版跑通一小段真实任务,确认输出格式符合预期。 打开网页版入口
开放平台与 Harness 批量调用到开放平台建密钥,长任务用 Harness 保留步骤痕迹。
帮助中心排查流程示意

Task 01

任务一 · 四项检查按顺序完成

鉴权、模型、消息、输出控制分别检查。前一项未通过时不继续修改后一项,避免把多个变量同时改动。DeepSeek网页版与接口报的是同一类问题,只是出现的位置不同。

01

任务:查鉴权

确认密钥未过期、未被回收,请求头中的认证字段拼写正确。

02

任务:查模型

确认模型名与版本一致,注意大小写与后缀。

03

任务:查消息

确认消息数组结构完整,角色字段与内容字段都在。

04

任务:查输出

确认输出长度上限足够,避免因截断误判为内容缺失。

Task 02

任务二 · 三类问题的处理路径

入口问题去网页版确认,DeepSeek AI 的调用问题查 DeepSeek api开放平台的字段与状态码,长任务问题用 Harness 逐步复现。三类问题不要混在一起改配置。

接口请求与返回字段对照示意
状态码排查界面示意

任务:入口与登录

打不开或会话丢失,先确认网络与登录状态,再清理本地缓存重试。

长任务执行记录示意

任务:长任务续跑

中断后按已有步骤继续,不要从头重跑,避免结果不一致。

任务:稳定输出

显式给出字段清单与示例,并限定只输出该结构。

任务:控制用量

设置并发上限与重试间隔,把失败请求单独记录后重放。

平台请求字段与状态码

下表列出 DeepSeek api开放平台常用请求字段与三类状态码的处理方式。字段名以平台当前文档为准,本表用于快速对照。

字段含义填写说明
model模型名与版本后缀保持一致,区分大小写。
messages消息数组按角色顺序排列,系统说明放在首位。
temperature采样温度需要稳定输出时取较低值。
max_tokens输出上限留出余量,避免结果被截断。
response_format输出格式要求结构化结果时显式声明。
状态码类别处理方式
401鉴权失败核对密钥与请求头,必要时重新生成密钥。
404模型或路径错误核对模型名与接口地址拼写。
429限流降低并发并加入退避重试,记录失败请求。
POST /v1/chat/completions
{
  "model": "deepseek-chat",
  "messages": [
    {"role": "system", "content": "只输出指定字段,不附加说明"},
    {"role": "user", "content": "按给定表头整理下列内容"}
  ],
  "temperature": 0.2,
  "max_tokens": 2048
}

Task 03

任务三 · 接入三步

1

任务:网页版验证

用真实任务的一小段测试输出格式。

确认后再写脚本,避免接口层与内容层问题混在一起。

2

任务:平台建密钥

在 DeepSeek api开放平台创建密钥。

设定用量上限与并发,保存调用记录便于对账。

3

任务:Harness 复现

长任务交给 DeepSeek Harness 分步执行。

保留每一步痕迹,便于中断续跑与两次结果对照。

Harness 两次运行对照

同一任务跑两遍,比较中间步骤而不是只看最终结果。中间步骤一致,结果才可信。

步骤RUN1RUN2是否一致
输入切分按章节切为 6 段按章节切为 6 段一致
要素抽取抽取 18 项抽取 18 项一致
格式整理输出表格 18 行输出表格 18 行一致
结果复核标记 2 处待核标记 2 处待核一致

Changelog

任务四 · 帮助中心更新

文档与排查步骤的改动都记在这里,每条写明影响范围。

图纸 H-02

本次修订:补充限流重试建议与 Harness 分步对照表。平台字段名未发生变更,已有脚本无需调整。

文档更新说明示意 文档

状态码处理补充

新增鉴权、参数、限流三类状态码的处理顺序与退避重试建议。

用法

结构化输出示例

补充字段清单写法与请求示例,减少因描述模糊造成的返工。

入口

入口排查合并

登录与会话问题统一并入入口排查一节,不再分散说明。

三轮核验记录

发布前对同一任务执行三轮核验,记录差异与处理结论。

轮次核验内容结论
第一轮字段与状态码对照字段名一致,补充限流说明
第二轮请求示例可执行性示例可运行,输出符合声明格式
第三轮Harness 两次运行对照中间步骤一致,结论可用

Voices

使用者反馈

以下引言说明他们按帮助中心的顺序排查后,把哪一步省了下来。

使用者的头像
以前报错就到处改配置,现在按鉴权、模型、消息的顺序查,十分钟能定位。
柳原数据工程师 / 福州
使用者的头像
长任务中断后按步骤继续,不用从头跑,两次结果能对上。
施宇研究工程师 / 济南
使用者的头像
在 DeepSeek网页版先验证格式再写脚本,返工次数明显少了。
曲青技术负责人 / 厦门

Faq

常见问题

按出现频率排序:先接入问题,再输出问题,最后是使用边界问题。

接口返回鉴权失败怎么办
先确认密钥是否过期或被回收,再检查请求头的认证字段拼写。修改后仍失败,用最小请求复现一次,排除业务内容的影响。
DeepSeek Harness 与普通调用有什么区别
普通调用一次返回结果;Harness 把长任务拆成多步执行并保留每一步的输入与输出,便于中断后续跑和两次结果对照。
结果被截断是模型的问题吗
多数是输出长度上限设置偏小。先提高上限并重跑,仍被截断再检查输入是否过长挤占了输出空间。
遇到限流应该如何处理
降低并发并加入退避重试,把失败请求单独记录后重放。不要在同一时刻集中重发,避免再次触发限流。
网页版能直接调用接口吗
不能。网页版面向对话使用,接口调用需要到 DeepSeek api开放平台创建密钥后按文档请求。
结构化输出有时多出说明文字
在系统消息里写清只输出指定结构,并给出示例。必要时改为两步:先抽取要素,再按清单整理。