ARTICLE · 1360979
一个参数,复刻一个 DeepSeek App
发布时间:2026-11-16 09:19:24 最近访问:2026-11-16 09:19:25
一个参数,复刻一个 DeepSeek App
以前要在自己的应用里做出 DeepSeek 网页端那种体验:边思考边搜、顺手读一下你贴的链接、把 PDF 丢进去直接问。这些事都得自己接搜索、自己解析文件、自己把结果拼回上下文,还要处理引用角标。11 月 13 日,DeepSeek 把这一整套搬进了 API。官方新闻页的描述是:开发者可以在自己的应用中轻松实现复杂的对话功能,「甚至 1:1 复刻出完整的 DeepSeek App」。一、一条新闻,三条接入路径
这次发布没有单独开一个新接口,而是把能力挂到了已有的三套协议上。 | |
|---|
| POST https://api.deepseek.com/anthropic/v1/messages |
| POST https://api.deepseek.com/responses |
| 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 秒。官方建议只在会话的第一次请求上打开。第四,思考。这一项三个协议的字段名不一样,容易写错: | |
|---|
| thinking.type + reasoning_effort |
| thinking.type + output_config.effort |
| 没有 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 调用是边合成边流式返回音频。 | | |
|---|
| 查询词 1~128 字符,条数 1~50(默认 10) | |
| | |
| | |
| 16 位 PCM WAV 或 Ogg Opus,8 MiB,时长 ≤120 秒 | |
| 10,000 计费字符(汉字算 2 个),请求体 64 KiB | |
四、价格:五条价格,四种单位
工具调用费与 Token 费是两笔账,官方原话是「除收取 Token 费用外,也将收取相关工具的调用费用」。 | |
|---|
| |
| |
| |
| 0.39 元/小时(划线 0.78,限时 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