错误信息: Unsupported value: 'reasoning_effort' does not support 'minimal' with this...

2025年12月15日 20:18 状态: processing

🚨 错误信息

错误名称: AI_APICallError 错误信息: Unsupported value: 'reasoning_effort' does not support 'minimal' with this model. Supported values are: 'none', 'low', 'medium', 'high', and 'xhigh'. 堆栈信息: AI_APICallError: Unsupported value: 'reasoning_effort' does not support 'minimal' with this model. Supported values are: 'none', 'low', 'medium', 'high', and 'xhigh'. at file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/dist-gixTQuVo.js:5132:11 at async postToApi (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/dist-gixTQuVo.js:5028:24) at async OpenAICompatibleChatLanguageModel$1.doStream (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:243343:48) at async wrapStream (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:38768:31) at async fn (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:36953:17) at async file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:34331:19 at async _retryWithExponentialBackoff (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:34433:10) at async streamStep (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:36921:108) at async fn (file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:37200:5) at async file:///C:/Users/Administrator/AppData/Local/Programs/Cherry%20Studio/resources/app.asar/out/renderer/assets/store-Oi5sAZNS.js:34331:19 错误原因: "[undefined]" 状态码: 400 请求路径: https://www.dmxapi.cn/v1/chat/completions 请求体: { "model": "gpt-5.2", "user": "[undefined]", "max_tokens": "[undefined]", "temperature": "[undefined]", "top_p": "[undefined]", "frequency_penalty": "[undefined]", "presence_penalty": "[undefined]", "response_format": "[undefined]", "stop": "[undefined]", "seed": "[undefined]", "serviceTier": "[undefined]", "reasoning_effort": "minimal", "verbosity": "medium", "messages": [ { "role": "user", "content": "你好" } ], "tools": "[undefined]", "tool_choice": "[undefined]", "stream": true, "stream_options": { "include_usage": true } } 响应首部: { "cache-control": "no-cache", "content-type": "text/event-stream", "date": "Mon, 15 Dec 2025 12:18:32 GMT", "document-policy": "include-js-call-stacks-in-crash-reports", "server": "nginx", "x-rixapi-request-id": "20251215201828855211195boDB1n28" } 响应内容: { "error": { "message": "Unsupported value: 'reasoning_effort' does not support 'minimal' with this model. Supported values are: 'none', 'low', 'medium', 'high', and 'xhigh'.", "type": "rix_api_error", "param": "reasoning_effort", "code": "unsupported_value" } } 数据: { "error": { "message": "Unsupported value: 'reasoning_effort' does not support 'minimal' with this model. Supported values are: 'none', 'low', 'medium', 'high', and 'xhigh'.", "type": "rix_api_error", "param": "reasoning_effort", "code": "unsupported_value" } }

🤖 AI解决方案

代码报错分析报告

1. 错误翻译

原文: 'reasoning_effort' does not support 'minimal' with this model. Supported values are: 'none', 'low', 'medium', 'high', and 'xhigh'.

译文: 当前模型不支持 'reasoning_effort' 参数值为 'minimal'。支持的值是:'none', 'low', 'medium', 'high' 和 'xhigh'。

2. 原因分析

这个错误是 API 参数验证失败(状态码 400)。

  • 根本原因: 在调用 AI 模型 gpt-5.2 时,向 reasoning_effort(推理力度)参数传递了一个无效值 "minimal"
  • 具体位置: 错误发生在向 https://www.dmxapi.cn/v1/chat/completions 发送 POST 请求时。API 服务端明确拒绝了 reasoning_effort: "minimal" 这个参数组合。
  • 3. 解决方案

    reasoning_effort 参数的值修改为 API 支持的值之一。根据错误信息,支持的值包括:"none", "low", "medium", "high", "xhigh"

    以下是请求体 "requestBody" 中需要修改的部分:

    {
      "model": "gpt-5.2",
      // ... 其他参数保持不变 ...
      "reasoning_effort": "medium", // 将 "minimal" 替换为支持的值
      "verbosity": "medium",
      "messages": [
        {
          "role": "user",
          "content": "你好"
        }
      ],
      "stream": true,
      // ... 其余部分保持不变 ...
    }

    快速修复建议:

  • "reasoning_effort": "minimal" 更改为 "reasoning_effort": "medium"(这是错误信息中提到的一个支持值)。

  • 或者,根据你的具体需求,从 ["none", "low", "medium", "high", "xhigh"] 中选择一个最合适的值。
  • 4. ️ 预防措施

  • 查阅官方文档: ️ 在使用特定模型(如 gpt-5.2)的高级参数(如 reasoning_effort)前,务必查阅该模型对应的最新API文档,确认参数的有效取值范围。

  • 实现参数验证: 在你的客户端代码中,在构造请求体之前,对即将发送的API参数进行前置校验。可以创建一个参数验证函数或使用枚举类型来确保只传递API支持的值,避免将无效参数发送到服务器。

---
总结: 此错误是由于API参数值不匹配导致的,修复方法是将无效的 "minimal" 替换为API明确支持的 "none", "low", "medium", "high", "xhigh" 中的一个。