11 月 13 日之前,调 DeepSeek 的 API 你买到的只是一个模型。它上不了网,读不了你刚上传的 PDF,也不知道今天几号。想做出接近 App 的体验,开发者得自己把管道焊起来:判断这句话要不要搜、调搜索接口、抓网页、截断、拼回 messages、再问一遍模型。五个环节,五处会坏的地方。

这次 DeepSeek 把整条链路搬到了服务端。

具体变了什么

deepseek-flash(也就是 DeepSeek-V4.1-Flash 的 API 名)现在接受一个 tools 数组,里面填的是能力名,不是函数名:

deepseek_web_search:模型自己判断要不要搜,回答自带来源链接。
叠加思考模式就是深度思考搜索,一次推理里自主多轮搜索、多轮读页。
deepseek_read_url:用户消息里贴了链接,服务端直接抓正文塞进上下文。
文件输入:PDF、Word、PPT、图片都能传,服务端解析,不用先转格式。
safety_check:对输入输出做审核,命中风险返回拒绝标记。

OpenAI 格式的 /v1/chat/completions 和 Anthropic 格式的 /v1/messages 都支持同一套工具。已有项目迁移,改三样:base_url、模型名、请求体里加一行。

机房机柜。服务端工具编排把这块活从你的代码里搬到了账单上。图:Carl Lender / Wikimedia Commons,CC BY 2.0
机房机柜。服务端工具编排把这块活从你的代码里搬到了账单上。图:Carl Lender / Wikimedia Commons,CC BY 2.0

钱怎么算

搜索和抓取跟 token 分开计,各按每千次 0.75 美元,走工具调用还是走独立接口都一样。文件解析和 OCR 每千页 0.225 美元。语音合成标价每万字 0.45 美元,目前五折;语音识别每小时音频 0.116 美元,同样在打折。

token 价格没动:deepseek-flash 缓存未命中、低谷每百万输入 0.15 美元,峰时 0.30 美元;输出每百万 0.60 到 1.20 美元。

那个没人提醒你的坑

这是新 API 反馈里出现频率最高的一条。直接问「DeepSeek 今天发布了什么」,模型搜回来的是 2 月的新闻。

不是它坏了,是它没有时钟。它会把「今天」映射到训练数据里最密集的那个时间段。

解法是在 system 里塞一条带日期的元信息,官方文档管这叫 latest reminder:

{"role":"system","content":"今天是 2026-11-17,星期二,位置:上海,界面:Web"}

社区实测,加上这一行之后,同一个问题从触发 12 次搜索、全是旧闻,变成 3 次搜索直接命中当日公告。

关键是每次请求都要重新生成。把 system message 缓存起来复用,第二天就过期了,而「过期」正是你想避免的那个故障。

最小可跑的一段

from openai import OpenAI

client = OpenAI(api_key="...", base_url="https://api.deepseek.com/v1")

r = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "今天是 2026-11-17,星期二。"},
        {"role": "user",   "content": "DeepSeek 这周发布了什么?"},
    ],
    tools=[{"type": "deepseek_web_search"}],
)
print(r.choices[0].message.content)

没有搜索 key,没有爬虫,没有分块逻辑。

什么时候该用底层接口

不需要对话就别为对话付钱。/v1/search 返回结果列表,/v1/fetch 返回正文,/v1/ocr 认字,/v1/asr、/v1/tts 处理语音。这几个都是无状态的,调一次返回一次。批量扫发票走 /v1/ocr,别挂在一次聊天请求上——那样你还要为模型「思考这张发票」付费。

切换前的三个检查

你的业务真的需要搜索吗?每一次触发的搜索都是一次计费调用,一个太爱搜的模型会安静地烧预算。

你的 prompt 里有日期吗?先补上,再去怪搜索结果。

你用的是 Harness 0.2.1-rc.1 或更高吗?旧版本的工具 schema 对不上,报错看起来像模型不行,其实是版本不对。

一句话总结:DeepSeek 卖了两年 token,现在开始卖 App 里那些真正好用的部件。对上层开发者来说,省掉一周管道,账单上多一行。