CherryStudio配置o4推理级别

更新于

适用范围:Cherry Studio 的 reasoning_effort 自定义请求参数;以所选推理模型支持的取值为准。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。图中的历史 o 系列仅作参数位置示例。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
reasoning_effort 类型String不要作为 JSON 对象填写。
reasoning_effort 值low / medium / high旧 o 系列示例;其他模型按其规范。
模型 ID当前可用的推理模型更换模型后重新核对支持值。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

第 1 步:选择已可用的推理模型

先按基础教程接通 apizt。在模型条目中选择令牌可用的推理模型,用默认参数完成一次短问答。历史截图中的 o 系列只表示配置位置。

第 2 步:添加 reasoning_effort

打开当前模型的自定义参数,名称填 reasoning_effort,类型选 String,先填 medium。旧 o 系列示例支持 low、medium、high;其他模型必须核对自己的支持范围。

第 3 步:检查参数是否随请求发送

保存模型设置,新开会话发送相同短问题。通过请求详情或可用的客户端日志核对参数。若出现 unsupported parameter,删除额外参数恢复默认,再确认所选模型的文档。

步骤1
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。
步骤2
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。
步骤4
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。
步骤3
历史版本界面参考;配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

怎样确认配置已生效

  1. 请求日志中包含选定的 reasoning_effort。
  2. 同一短问题能正常返回正文。

接入失败时逐项检查

现象检查与处理
参数不被支持删除 reasoning_effort 先测试默认请求,核对当前模型文档。
参数未发送确认自定义参数保存在当前使用的模型条目中。
高级取值导致 400使用该模型支持的值,不能由旧 o 系列范围推断所有新模型。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。