夜雨聆风学习资料网

ARTICLE · 1360979

一个参数,复刻一个 DeepSeek App

一个参数,复刻一个 DeepSeek App
以前要在自己的应用里做出 DeepSeek 网页端那种体验:边思考边搜、顺手读一下你贴的链接、把 PDF 丢进去直接问。这些事都得自己接搜索、自己解析文件、自己把结果拼回上下文,还要处理引用角标。
11 月 13 日,DeepSeek 把这一整套搬进了 API。官方新闻页的描述是:开发者可以在自己的应用中轻松实现复杂的对话功能,「甚至 1:1 复刻出完整的 DeepSeek App」。

一、一条新闻,三条接入路径

这次发布没有单独开一个新接口,而是把能力挂到了已有的三套协议上。
协议
接口
Messages
POST https://api.deepseek.com/anthropic/v1/messages
Responses
POST https://api.deepseek.com/responses
Chat Completions
POST https://api.deepseek.com/chat/completions
官方要求使用 deepseek-flash 模型;其他模型是否同样支持,官方没有说明。
清单比新闻页长。新闻页点名了五项(联网搜索、深度思考搜索、文件输入、阅读链接、模型安全),官方指南的功能对照表却列了九项:
能力
一句话
联网搜索
非思考模式下,模型按提问自动搜网页或图片,附引用作答
深度思考搜索
思考模式下,在多步推理中自己搜索、打开网页、页内查找
文件输入
PDF、Word、PowerPoint、图片,解析后拼进上下文
阅读链接
自动识别用户消息里的链接并抓取正文
模型内容安全
审核输入输出,命中风险返回拒答标识
用户元信息标记
把日期、所在地、语言告诉模型
会话标题
回答结束时顺带生成标题
朗读回答
把回答合成为语音
语音输入
把语音识别成文字
多出来的四项里,最容易漏掉的是用户元信息标记。网页端会悄悄喂给模型四样东西:今天几号、你在哪、什么平台、什么语言。换成 API,就得你自己用一条 latest_reminder 角色的消息补上,格式是 <日期>,<星期>,<所在地>,<平台>,<语言>。Responses API 不支持这个角色。

二、四个开关

这些东西全都靠请求体里的字段打开。真正要记的是四个开关,其中 safety_check 和 title 算可选增强,最小可用形态只是往 tools 里声明工具。标题说的「一个参数」,指的就是这一类开关。
第一,工具。tools 里声明两个内置工具,不需要写 input_schema。官方没给它们任何 parameters 定义,传类型就够了:
”tools”: [  {”type”: ”deepseek_web_search”},  {”type”: ”deepseek_read_url”}]
第二,安全校验。"safety_check": {"level": "high"}。只有 low 和 high 两个值,low 等于不传;写错返回 400。它单独使用时不会联网,此时 tool_choice 只能是 auto 或 none。
第三,会话标题。"title": {"enabled": true}。标题是模型回答时顺带生成的,不需要额外请求,也不计费;代价是回答结束后最多再等 5 秒。官方建议只在会话的第一次请求上打开。
第四,思考。这一项三个协议的字段名不一样,容易写错:
协议
思考字段
Chat Completions
thinking.type + reasoning_effort
Messages
thinking.type + output_config.effort
Responses
没有 thinking 对象,用 reasoning.effort
下面这段最小请求照官方示例改写,Chat Completions 协议,开了搜索、安全校验和会话标题(本文未实测):
curl https://api.deepseek.com/chat/completions \  -H ”Content-Type: application/json” \  -H ”Authorization: Bearer $DEEPSEEK_API_KEY” \  -d '{    ”model”: ”deepseek-flash”,    ”thinking”: {”type”: ”enabled”},    ”tools”: [      {”type”: ”deepseek_web_search”},      {”type”: ”deepseek_read_url”}    ],    ”safety_check”: {”level”: ”high”},    ”title”: {”enabled”: true},    ”messages”: [{”role”: ”user”, ”content”: ”DeepSeek V4.1 有哪些更新?”}],    ”stream”: true  }'

三、五个独立接口

同一批能力也能拆出来单点调用,适合已经有自己编排逻辑的场景。五个接口都没有创建任务、再轮询这类异步形态;其中 TTS 的 HTTP 调用是边合成边流式返回音频。
接口
路径
一次调用的输入
Search
/v1/tools/search
查询词
Fetch
/v1/tools/fetch
一个 URL
OCR
/v1/tools/ocr
一个文件
ASR
/v1/tools/asr
一段音频
TTS
/v1/tools/tts
一段文本
限制和限速:
接口
限制
限速
Search
查询词 1~128 字符,条数 1~50(默认 10)
100 QPS
Fetch
URL 不超过 8,192 字符,不能带账号密码
25 QPS
OCR
100 MiB、1,000 页,上传 120 秒
15 个同时识别
ASR
16 位 PCM WAV 或 Ogg Opus,8 MiB,时长 ≤120 秒
50 个同时请求
TTS
10,000 计费字符(汉字算 2 个),请求体 64 KiB
50 个同时请求

四、价格:五条价格,四种单位

工具调用费与 Token 费是两笔账,官方原话是「除收取 Token 费用外,也将收取相关工具的调用费用」。
项目
价格
文字 / 图片搜索
5 元/千次
网页抓取
5 元/千次
文字识别
1.5 元/千页
语音识别
0.39 元/小时(划线 0.78,限时 5 折)
语音合成
1.5 元/万字符(划线 3.0,限时 5 折)

参考资料

《DeepSeek 发布全家桶应用 API》(2026/11/13)
https://api-docs.deepseek.com/zh-cn/news/news261113
《构建 Chatbot》(能力对照表、四个开关、三协议字段差异)
https://api-docs.deepseek.com/zh-cn/guides/build_a_chatbot

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料