问题触发条件报错信息实际原因规避方案system 超限system prompt > ~12K tokens（实测值，非官方）单轮 system 疑似有隐藏上限拆分到 user 轮tool_call_id 不匹配多轮 tool use 后 id 对不上格式校验比 OpenAI 严格发送前校验 id 一致性流式不关闭max_tokens 截断 + stream=true无报错，连接挂起疑似 bug：

最近把项目里的 DeepSeek V3 升级到新版本，结果同一套代码开始出现 500 错误。错误信息只有一句冷冰冰的，没有任何有用的字段提示。排查下来，主要集中在两类请求格式问题：① system message 里混入了 Unicode 控制字符；② tools 参数传了空数组[]。下面展开讲怎么排查和修。：本文基于实际排查经验整理，部分涉及模型内部行为的描述（如版本间容错差异）为推测，Deep

最近把项目里的 DeepSeek V3 升级到新版本，结果同一套代码开始出现 500 错误。错误信息只有一句冷冰冰的，没有任何有用的字段提示。排查下来，主要集中在两类请求格式问题：① system message 里混入了 Unicode 控制字符；② tools 参数传了空数组[]。下面展开讲怎么排查和修。：本文基于实际排查经验整理，部分涉及模型内部行为的描述（如版本间容错差异）为推测，Deep

上周三智谱把 GLM-5 升级到 GLM-5.1，我项目里十几个调用点全炸了。控制台没有任何迁移说明，报错信息也只给一句——我还以为是 Key 过期了，重新生成了两遍才意识到是 endpoint 路径和模型标识符都改了。这篇把我填的坑整理出来，省得你再绕一圈。GLM-5.1 相比 GLM-5 有两处未经通知的差异：一是 base_url 从变成了（注：v5 路径为作者实测结果，官方文档截至撰文时尚

上个月帮朋友的创业团队接 MiniMax，我前后搞了两遍才跑通。第一遍照着官方示例抄，死活报 401；第二遍仔细翻了下旧版接口文档才发现——MiniMax 的鉴权体系跟 OpenAI 那套不太一样，group_id这个东西在某些接口里是必须随请求传的，而且遗漏它返回的是 401 而不是 400，容易让人误以为是 Key 配错了。这篇把我踩过的坑全拆开讲，供参考。

GPT-Image-2 老是生成失败？完整排查和修复指南，5 个真根因逐个击破GPT-Image-2 的处理时间比文字模型长很多——高质量 1024px 需要 145-280 秒。大多数所谓的"生成失败"其实不是模型问题，而是网络链路（CDN、反代、SDK）提前断开了连接。这篇文章总结了实际使用中最常遇到的 5 类问题，每个都附了可以直接用的修复代码。

我不想用一个漂亮的结论来收尾，因为我自己也还没想清楚。但有一点我比较确定：Gowers 那篇博客里描述的那 17 分钟，是一个值得认真对待的信号。不是因为它证明了 AI「有多厉害」，而是因为它来自一个极其可靠的观察者，在一个极其难以造假的领域，给出了一个极其具体的案例。这种信号，比一千篇「AI 改变世界」的营销文章更值得花时间消化。原文出处：Timothy Gowers 博客，

用 Claude Code 写代码有一个很烦的事：每一轮对话结束，它就停下来等你回复。改一个 bug 要来回五六轮，你得一直盯着终端，看它改完了没，然后敲回车让它继续。本质上你变成了一个人肉"继续"按钮。v2.1.139 加了两个命令，直接解决了这个问题。/goal让 Claude 自己干到满足条件为止，不用你催；打开一个多会话管理面板，让你同时派发好几个任务，哪个卡住了一眼就能看到。这篇文章是我

问题触发条件报错信息实际原因规避方案system 超限system prompt > ~12K tokens（实测值，非官方）单轮 system 疑似有隐藏上限拆分到 user 轮tool_call_id 不匹配多轮 tool use 后 id 对不上格式校验比 OpenAI 严格发送前校验 id 一致性流式不关闭max_tokens 截断 + stream=true无报错，连接挂起疑似 bug：

上个月帮朋友的创业团队接 MiniMax，我前后搞了两遍才跑通。第一遍照着官方示例抄，死活报 401；第二遍仔细翻了下旧版接口文档才发现——MiniMax 的鉴权体系跟 OpenAI 那套不太一样，group_id这个东西在某些接口里是必须随请求传的，而且遗漏它返回的是 401 而不是 400，容易让人误以为是 Key 配错了。这篇把我踩过的坑全拆开讲，供参考。