CherryStudio配置o4推理级别
官方入口:Cherry Studio 官方下载
适用范围: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,删除额外参数恢复默认,再确认所选模型的文档。




怎样确认配置已生效
- 请求日志中包含选定的 reasoning_effort。
- 同一短问题能正常返回正文。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 参数不被支持 | 删除 reasoning_effort 先测试默认请求,核对当前模型文档。 |
| 参数未发送 | 确认自定义参数保存在当前使用的模型条目中。 |
| 高级取值导致 400 | 使用该模型支持的值,不能由旧 o 系列范围推断所有新模型。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。