API返回参数finish_reason枚举值更新
更新时间：2025-08-04
概述
为了更好的兼容 OpenAI 生态，降低您的使用或迁移成本，我们将于（3月12日 20:00）对 推理服务v2 的返回参数 finish_reason 的枚举值进行更新。此次更新主要涉及枚举值的合并和调整，以使其与 OpenAI 的定义保持一致。
变更内容
-
合并 normal 和 stop 为 stop:
- 原 normal 和 stop 枚举值合并为 stop，表示模型自然停止或命中提供的停止序列。
-
更新后的 finish_reason 枚举值:
- stop: 模型自然停止或命中提供的停止序列。
- length: 达到了请求中指定的最大 token 数。
- content_filter: 由于内容过滤器的标志，部分内容被省略。
- tool_calls: 模型调用了工具。
影响
- 兼容性: 此次更新提高了与 OpenAI 生态的兼容性，降低了用户迁移成本。
- 代码修改: 对于已经使用 finish_reason 参数进行业务逻辑处理的用户，必须修改其代码以适应新的枚举值名称。
迁移指南
- 检查代码: 检查所有使用 finish_reason 参数的代码，确保其能够正确处理新的枚举值。
- 更新逻辑: 将原 normal 和 stop 的逻辑合并为 stop 的处理逻辑。
问题与支持
如果在迁移过程中遇到任何问题，请联系我们的支持团队。 感谢您的理解与支持！