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 不支持正则语法。
热门专题
热门推荐
加密货币行业翘首以盼的监管里程碑,终于有了实质性进展。美国证券交易委员会(SEC)主席保罗·阿特金斯(Paul Atkins)近日证实,那份允许加密项目在早期获得注册豁免权的“安全港”框架提案,已经正式送抵白宫,进入了最终审查阶段。 在范德堡大学与区块链协会联合举办的数字资产峰会上,阿特金斯透露了这
微策略Strategy报告:第一季录得144 6亿美元浮亏 再斥资约3 3亿美元买进4871枚比特币 市场震荡的威力有多大?看看Strategy的最新季报就明白了。根据其最新向美国证管会(SEC)提交的8-K报告,受市场剧烈波动影响,这家公司所持的比特币在第一季度录得了一笔惊人的数字——144 6亿
稳定币巨头Tether的动向,向来是加密世界的风向标。这不,它向Web3基础设施的版图扩张,又迈出了关键一步。公司执行长Paolo Ardoino在社交平台X上透露,其工程团队正在全力“烹制”一个新项目——去中心化搜索引擎 “Hypersearch”。这个消息一出,立刻引发了行业的广泛猜想。 采用D
基地位于Coinbase旗下以太坊Layer2网络Base的Seamless Protocol,日前正式宣告了服务的终结。这个曾经吸引了超过20万用户的原生DeFi借贷协议,在运营不到三年后,终究没能跑赢时间。它主打的核心产品是Integrated Leverage Markets(ILMs)——一
PAAL代币揭秘:深度解析Web3社区治理的核心钥匙 在去中心化自治组织的浪潮中,谁真正掌握了项目的话语权?PAAL代币提供了一套系统化的答案。它不仅是生态内流转的价值媒介,更是开启链上治理大门的核心凭证。通过持有并质押PAAL代币,用户能够对协议升级、资金分配乃至战略方向等关键事务投出决定性的一票





