广告位联系
返回顶部

DeepSeek Harness全家桶API配置介绍

Ai 来源:互联网 作者:佚名 发布时间:2026-11-16 21:54:04 人浏览
摘要

发布日期:2026-11-16 | 数据基准:DeepSeek 官方 API 文档、2026-11-13 全家桶 API 公告 | 适用版本:DeepSeek-V4.1-Flash(deepseek-flash)、DSH v0.8.3 2026年11月13日,DeepSeek 正式开放全家桶应用 API,把 App 里的联

发布日期:2026-11-16 | 数据基准:DeepSeek 官方 API 文档、2026-11-13 全家桶 API 公告 | 适用版本:DeepSeek-V4.1-Flash(deepseek-flash)、DSH v0.8.3

2026年11月13日,DeepSeek 正式开放"全家桶应用 API",把 App 里的联网搜索、文件输入、读链接、语音交互、安全校验五大能力全部打包进原有 API 接口。过去开发者需要自行对接搜索引擎、解析 PDF、拼接上下文,现在在请求体里加一个 tools 参数就能搞定,服务端接管了所有工具调用和上下文拼接的脏活。DeepSeek Harness(DSH)作为官方开源的插件化 Agent 客户端,可以在 UI 里直接勾选启用这些新能力,日活已超 154 万。本文从 API 能力矩阵到 Harness 配置路径,完整覆盖实操步骤,重点拆解一个高频踩坑——不注入日期元信息会导致联网搜索命中历史新闻。

DeepSeek Harness API配置

以前的 DeepSeek API 是毛坯房

在 11 月 13 日之前,调用 DeepSeek API 拿到的只是一个模型。它不会上网,不知道今天是几号,也读不了 PDF。想做出接近 App 体验的产品,开发者的典型流程是:先让模型判断要不要搜索,调用 Search 找网页,再用 Fetch 读取网页内容,把结果截断拼回 messages 里,最后再让模型根据这堆上下文作答。每一步都要自己写代码串联,出错了还得一节节排查。

10 月 17 日 DeepSeek 开放了独立的 Search 和 Fetch 接口,往前推了一步,但工具调用和模型之间的衔接逻辑还是得开发者自己处理。

这次升级把这些活全搬到了服务端。

11 月 13 日:毛坯变精装

全家桶 API 的核心变化是:服务端自动完成"要不要搜 → 搜什么 → 读哪些网页 → 拼到上下文"这条链路,开发者只需要在请求里声明要用哪些工具。

目前只有 deepseek-flash(即 DeepSeek-V4.1-Flash)支持全家桶能力,OpenAI 和 Anthropic 两种协议的接口都可以用:/v1/chat/completions、/v1/messages(Responses 端点)、/v1/messages(Anthropic Messages 端点)三个调用入口均支持。

五大对话内置能力,在请求体 tools 字段里声明即可:

能力 参数名 说明
联网搜索 deepseek_web_search 模型自判断是否上网,回答自带来源链接
深度思考搜索 思考模式 + deepseek_web_search 多步推理中自主多轮搜索+读网页
读链接 deepseek_read_url 消息里附 URL,服务端自动抓取内容
文件输入 上传附件(PDF/Word/PPT/图片) 服务端解析后拼入上下文,无需手动转格式
安全校验 safety_check 对输入和输出自动审核

此外,Search(搜索)、Fetch(网页抓取)、OCR(文字识别)、ASR(语音识别)、TTS(语音合成)五个底层能力也开放为独立接口,支持单独或组合调用。联网搜索定价 ¥5/千次,OpenAI 和 Anthropic 同类工具约 $10/千次。

最快的上手方式是官方开源的演示客户端 deepseek-ai/chat-demo,在线体验地址 https://deepseek-ai.github.io/chat-demo/,填上 API Key 就能用,Key 和对话记录只存在浏览器本地,没有后端。

代码接入:三个场景实操

场景一:联网搜索

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

from openai import OpenAI

client = OpenAI(

    api_key="your_api_key",

    base_url="https://api.deepseek.com/v1"

)

response = client.chat.completions.create(

    model="deepseek-flash",

    messages=[

        {

            "role": "system",

            "content": "今天是 2026-11-16,星期日,位置:上海,界面:Web,语言:中文"

        },

        {"role": "user", "content": "DeepSeek 最近有什么新功能?"}

    ],

    tools=[{"type": "deepseek_web_search"}]

)

print(response.choices[0].message.content)

注意 system 里那条日期信息,后面会详细解释为什么少不了它。

场景二:上传文件

1

2

3

4

5

6

7

8

9

10

11

12

13

14

# 先上传文件拿到 file_id

with open("report.pdf", "rb") as f:

    file = client.files.create(file=f, purpose="assistants")

 

response = client.chat.completions.create(

    model="deepseek-flash",

    messages=[{

        "role": "user",

        "content": [

            {"type": "file", "file": {"file_id": file.id}},

            {"type": "text", "text": "总结这份报告的核心观点"}

        ]

    }]

)

PDF、Word、PPT、图片都支持,服务端自动解析,不用手动转格式或截断。

场景三:独立调用 OCR

1

response = client.post("/v1/ocr", files={"image": open("invoice.png", "rb")})

适合不需要对话上下文、只想识别图片文字的场景,比如发票 OCR、扫描件提取。

一个必知坑:联网搜索会搜到历史新闻

这是目前反馈最多的问题。直接问"DeepSeek 今天发布了什么",模型实际搜出来的是 2026 年 2 月的新闻。原因是模型不知道当前日期,会把"今天"映射到训练数据里最密集的某个时间点。

官方的解法是在每次请求前注入一条元信息,DeepSeek 文档里称为 latest_reminder:

1

2

3

4

{

    "role": "system",

    "content": "今天是 2026-11-16,星期日,位置:上海,界面:Web,语言:中文"

}

DeepSeek 网页版每一轮对话都会自动加这条,所以网页版用起来准确,API 调用默认没有。加上之后,同样的问题从触发 12 次搜索(搜的全是历史新闻)→ 只搜 3 次直接命中当日内容。

每次请求都要带上当天日期,不要只在第一条 system message 里写一次然后复用 session,日期会过期。

用 Harness 配:UI 里直接勾选,不写代码

如果不想自己写调用逻辑,DeepSeek Harness(DSH)是最快的路径。DSH 是 DeepSeek 2026 年 8 月开源的插件化 Agent 框架,核心理念是 Agent = Model + Harness,日活 154 万(截至 11 月 4 日)。

安装只需要一行:

1

npx @deepseek-ai/dsh web

启动后,在 设置 → 会话 → 工具 里勾选 deepseek_web_search、deepseek_read_url 等,切换模型为 deepseek-flash,全家桶能力就全部激活了,DSH 会自动在每次请求里注入 latest_reminder,不用手动处理日期坑。

Harness 也支持接入其他兼容 OpenAI 协议的 API 端点。七牛云的 AI 推理服务兼容 DeepSeek Harness 的配置格式(官方文档:developer.qiniu.com/aitokenapi/13550),配置路径是 设置 → 模型 → 自定义设置,API 地址填 https://api.qnaigc.com/v1,模型 ID 在七牛控制台的模型广场查询,接入后全家桶工具参数照常使用。七牛云同时接入了多款主流大模型,适合需要在不同模型之间切换对比效果的场景。

底层接口:Search / Fetch / OCR / ASR / TTS

这五个底层接口适合已有工作流的开发者,比如:

  • 只需要搜索结果列表(不经过模型)→ 直接调 /v1/search
  • 只需要抓取某个网页正文 → 调 /v1/fetch
  • 批量处理扫描件 → 调 /v1/ocr,不用带模型推理成本
  • 语音转文字 → /v1/asr,文字转语音 → /v1/tts

和对话接口不同,这些底层接口是无状态的,调一次返回一次,没有上下文管理,适合集成进现有管道。

迁移已有项目:改一行 base_url

如果项目里已经用了 OpenAI SDK 调用其他模型,切换到 DeepSeek 全家桶 API 只需要:

  1. 把 base_url 改为 https://api.deepseek.com/v1
  2. 把 model 改为 deepseek-flash
  3. 在 tools 里加需要的能力参数
  4. 在 system message 里加日期元信息

Anthropic SDK 用户同理,把 base_url 换成 DeepSeek 的 Messages 端点,模型名填 deepseek-flash。

如果原来调用的是其他兼容 OpenAI 协议的服务,base_url 对应替换即可,参数结构不变。

小结

11 月 13 日的全家桶 API 开放,本质是 DeepSeek 把服务端工具编排的能力外包给了开发者——原来只有官方 App 才能用的联网搜索+文件理解+语音能力,现在直接打包进 API,开发者不用再维护一套自己的工具串联逻辑。Harness 是最快的上手路径,不写代码也能在 UI 里把能力开起来。唯一需要额外注意的是日期元信息,漏掉它会让联网搜索命中历史内容。联网搜索 ¥5/千次的定价,是目前主流搜索增强 API 里最低的档位之一。

以上配置基于 2026 年 11 月 DeepSeek 官方公告及 DSH v0.8.3 文档,API 参数可能随版本迭代更新,接入前请以 DeepSeek 开放平台最新文档为准。


版权声明 : 本文内容来源于互联网或用户自行发布贡献,该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权, 违法违规的内容, 请发送邮件至2530232025#qq.cn(#换@)举报,一经查实,本站将立刻删除。
原文链接 :
相关文章
  • 本站所有内容来源于互联网或用户自行发布,本站仅提供信息存储空间服务,不拥有版权,不承担法律责任。如有侵犯您的权益,请您联系站长处理!
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计