OpenAI API兼容格式请求参数 – stop

导航栏:首页 / AI开发参考资料 / OpenAI API 兼容格式参考资料 / 请求参数详解 / stop

如果您想深入了解如何借助 OpenAI API 打造人工智能硬件,欢迎访问本站教程目录页,查看太极创客团队为您精心准备的系列教程。

参数说明

stop参数用于定义模型生成内容的终止条件。当模型生成的文本中出现任何一个指定的停止序列时,生成过程将立即停止,返回已生成的内容(不包含停止序列本身)。

该参数可以接受:

  • 单个字符串:当生成内容中出现该字符串时停止
  • 字符串数组:当生成内容中出现数组中的任何一个字符串时停止

默认值为null,表示模型将继续生成内容直到达到max_tokens限制或自然结束。


必需性

stop是API请求中的可选参数。


使用示例

基本用法

{
  "model": "gpt-5.2",
  "prompt": "请简要介绍人工智能:",
  "stop": ""
}

此示例将在生成第一个句号时停止,确保响应简洁明了。

多停止序列

{
  "model": "gpt-5.2",
  "prompt": "请列出三种编程语言:",
  "stop": ["\n", ""]
}

此示例将在生成换行符或句号时停止,确保响应不会包含多余的内容。

格式控制

{
  "model": "gpt-5.2",
  "prompt": "请以JSON格式返回用户信息:",
  "stop": "}"
}

此示例将在生成JSON闭合大括号时停止,确保返回完整的JSON对象。


注意事项

  • 停止序列长度限制:最多可指定 4 个停止序列,单个停止序列长度不宜过长,以免影响模型生成逻辑与效率。
  • 区分大小写:停止序列匹配是区分大小写的
  • 不包含停止序列:返回的响应中不会包含停止序列本身
  • 优先级:stop参数优先于max_tokens参数

常见问题

Q: stop参数和max_tokens参数有什么区别?

A: stop参数基于内容停止生成,而max_tokens参数基于令牌数量停止生成。如果同时设置,stop参数的优先级更高。

Q: 可以使用正则表达式作为停止序列吗?

A: 不可以,stop参数只接受固定字符串作为停止序列,不支持正则表达式。

Q: 停止序列的最大数量是多少?

A: 最多可以设置4个停止序列。