调用第三方deepseek-v4-flash。偶发"The reasoning_content in the thinking mode must be passed back to the API."

[E2E-AK-OI]

本轮运行失败400: {"message":"The reasoning_content in the thinking mode must be passed back to the API.","type":"bad_response_status_code","param":"","code":"bad_response_status_code"}

[weijiafu14]

这个报错有一个明确的成因和一行配置的解——而且"偶发"这一点正好是它的指纹。

为什么是偶发：只有"回放带思考的历史"时才会炸

The reasoning_content in the thinking mode must be passed back to the API. 的意思是：这个端点要求，你在后续请求里重放历史的 assistant 消息时，必须把当时的 reasoning_content 一起带回去。

所以：

• 第一轮（历史里还没有带思考的 assistant 消息）→ 正常；
• 之后某一轮（历史里已经有一条思考模式的 assistant 消息，而请求里没带 reasoning_content）→ 400。

这就是你看到的"偶发"——它不是随机，是只在满足那个条件的轮次上必然发生。开了思考、聊了几轮之后撞上的概率就高。

解法：给这个模型声明一个 compat 开关

DSH 官方的 llm-pi-ai profile 有一个正是为此存在的字段：

llm-pi-ai:
  providers:
    your-provider:                     # 你那个第三方路由的名字
      api: openai-completions
      baseURL: https://<你的端点>/v1
      apiKeyEnv: YOUR_API_KEY_ENV
      models:
        - id: deepseek-v4-flash
          contextWindow: 131072
          compat:
            requiresReasoningContentOnAssistantMessages: true    # ← 就是这一行

声明之后，后续请求在重放思考模式的 assistant 消息时会把 reasoning_content 带上，那个 400 就不会再出现。

几个坑要提前说：

1. 一次只加一个键。 这个 compat 槽位是按协议 gated 的受控子集，而且一个非法键会让整个 settings 段被拒——不是只忽略那一个键。所以先只加这一行、起一次、确认生效，再考虑别的。
2. 必须是 api: openai-completions 的路由，这个字段只对该协议开放。
3. 这条路是纯 DSH 官方配置，不需要装任何东西。

证据与边界

compat 声明能真正打到线上这件事，我们有实测：用一个透传录制代理（请求真发给上游、真实响应原样流回，中间只多存一份请求体）录到的 body 里，声明的 compat 值确实改变了发出去的报文形状（我们验的那次是 supportsDeveloperRole: false → 发出去的是 "role":"system" 而不是 "developer"，另外还验了 max_tokens 的非默认拼写和 store 字段消失）。

边界要说清：

• 我实测过的是同一个 compat 槽位能生效，但没有专门测过 requiresReasoningContentOnAssistantMessages: true 这一个键在你这个端点上的效果——它在字段表里、协议也对得上，但最终以你试的结果为准；
• 如果加上之后报错依旧，那说明这个端点要的不是标准的 reasoning 重放形状，那就变成另一个问题了，值得把加了配置之后的完整报错贴回来。

顺带：这一族已经有好几帖了

同类端点方言导致的 400，这个社区里至少有三帖在讨论，你可以对照着看有没有别的坑等着你：

• #780 —— 正是这两个开关（requiresReasoningContentOnAssistantMessages 和 supportsDeveloperRole）的提案，里面 opencode zen 那个例子和你这个报错一模一样；
• #1771 —— 同一族，还带一个历史回放的空指针崩溃；
• #2822 —— openai-responses 路由必发下划线 header 名，拒绝的网关直接 400，而那个字段目前还没有配置面。

共同的教训是：自动探测只能枚举一方端点，第三方网关的方言封不住——所以能显式声明的就显式声明，别指望它猜对。

边界与利益相关

我们不修 DSH 自家组件——llm-pi-ai、compat schema 都在 DSH 里。上面那段 YAML 是纯 DSH 官方配置。

利益相关：我维护 pi2dsh（Pi 生态兼容层）。这条不推销——我们只是因为要翻译这些 compat 字段，所以对它们格外熟；你不需要装我们任何东西。

[E2E-AK-OI]

加上compat后，经测试，已经解决问题。感谢！