DeepSeek API自定义停止词设置指南：巧用stop参数

要使用 API 请求体中的 stop 参数来配置停止词，从而实现文本生成的终止。该参数支持字符串数组形式，要求每个字符串的长度在 1 到 16 个字符之间，不能包含控制符，且必须完全匹配。最终，需要验证返回的 finish_reason 字段为 “stop”。

如果您在调用 DeepSeek API 时，希望模型在生成文本过程中遇到特定字符串就立刻停止输出，那么就需要通过请求体中的 stop 参数进行配置。以下是实现该功能的具体步骤：

一、确认 API 版本与模型兼容性

DeepSeek-VL 和 DeepSeek-Coder 系列模型均支持 stop 参数，但 DeepSeek-MoE 等稀疏架构模型可能会限制该字段的使用。您需要查阅所用模型的最新文档，以确认是否启用了停止词功能。

1、访问 DeepSeek 最新的 API 文档页面，定位到 “Request Parameters” 章节。

2、查找 stop 字段的说明，核对支持的模型列表及最大停止词数量（通常为 4 个）。

3、确认当前调用的 model 名称与文档中标注的支持状态一致。

二、构造包含 stop 数组的 JSON 请求体

stop 参数必须为字符串数组，每个元素是长度不小于 1、不大于 16 个 Unicode 字符的非空字符串，且不能包含控制字符或换行符。

1、在请求体 JSON 中添加 "stop" 键，其值为方括号包裹的字符串列表。

2、将目标停止词逐个写入数组。例如，若需要在遇到 “答：” 或 “###” 时截断，应写作 ["答：", "###"]。

3、确保整个 JSON 结构语法合法，逗号后无多余空格，引号为英文双引号。

三、处理多字节与标点敏感场景

中文标点、全角符号及 emoji 均被视为独立 token。若停止词包含此类字符，必须严格匹配原始编码形态，否则无法触发截断。

1、使用 Python 的 json.dumps() 序列化请求体，设置 ensure_ascii=False 以保留中文字符原貌。

2、对停止词执行 .strip() 操作，移除首尾不可见空白符（如 U+200B 零宽空格）。

3、若需匹配句号结尾，应同时提供 “。” 和 “.” 两个版本，因为模型分词器可能将其切分为不同 token。

四、验证停止行为是否生效

服务端仅在生成 token 流中检测到完全相同的字符串序列时才会终止，不会进行子串匹配或模糊匹配。

1、发起一次测试请求，将 stop 设为 [" "]，观察返回文本是否在首个连续两个换行处结束。

2、检查响应中 choices[0].finish_reason 字段值是否为 "stop"，而非 "length" 或 "null"。

3、对比未设 stop 时的输出长度与设值后的输出，确认截断位置精确对应数组中任一字符串的末尾字符。

五、规避常见配置错误

非法的 stop 值将导致 API 返回 HTTP 400 错误，错误信息中 message 字段会明确提示具体违规项。

1、删除数组中重复出现的字符串，如 ["。", "。"] 会被拒绝。

2、避免使用空字符串 "" 或仅含空格的字符串，如 "　"（全角空格）。

3、当需停止于数字序号后，应写为 ["1.", "2.", "3."]，而非正则表达式形式 "d+."——API 不支持正则语法。