先看哪一部分
同时保留 HTTP 状态码和响应正文。业务错误code 不一定等于 HTTP 状态；不同协议返回的错误结构也可能不同。
下面是现有接口文档中的业务错误示例：
20012 当成 HTTP 状态码。
常见 HTTP 状态
业务正文中的
code: 300 表示现有文档记录的安全问题，不是 HTTP 300 跳转。遇到安全拒绝先核对请求内容与错误说明，无法定位时提交脱敏材料。
Claude 返回 422，提示 model_id 错误、不支持或已下线，怎么办？
先从 NoneLinear 模型列表复制完整 Model ID，核对版本号、小数点、连字符及所用接口。 平台的模型 ID 可能与上游命名不同。例如此前的配置更正中，claude-opus-5-5 应改为平台列表中的 claude-opus-5.5。当前可用型号仍以平台列表为准。
名称正确但仍报错时，保留请求 ID、模型 ID、调用时间和报错原文，联系技术支持核查模型状态与账号权限。
这条处理适用于响应明确提示模型 ID 问题的情况；其他 422 错误应按响应中的参数说明排查。
DeepSeek 提示 reasoning_content 必须传回，怎么处理？
在 DeepSeek 思考模式下，携带tools 的 Chat Completions 请求需要回传历史 assistant 消息中的 reasoning_content。如果客户端或代码丢弃了这个字段，可能收到：
- 代码调用：构建后续
messages时，保留 assistant 消息中返回的reasoning_content、工具调用及对应工具结果，不要用空值替换已有思考内容。 - 第三方客户端：检查其 DeepSeek 思考模式与工具调用兼容性，使用支持该字段回传的版本。
- 切换协议：只有模型、平台和客户端均支持 Anthropic Messages 时，才考虑切换协议并新建会话；请求体也必须使用 Messages 格式。
tools 的普通多轮请求不要求回传历史 reasoning_content，不要把这项要求套用于所有对话。
协议依据：DeepSeek 官方思考模式说明。
GPT 返回内容安全拦截，是平台还是上游返回的？
如果响应明确提示上游模型的内容安全限制，该限制由上游服务执行，NoneLinear 无法直接解除。 先读完整错误类型和说明，区分内容安全拦截、鉴权失败和额度限制；不能仅凭 HTTP 状态码或“请求失败”判断拦截来源。 正常业务内容被误拦截，或无法确认来源时，请提供请求 ID、模型 ID、调用时间和脱敏报错，联系技术支持核查。有过滤政策更宽松的 GPT 备用渠道吗？
目前不提供过滤政策更宽松的 GPT 备用渠道。 正常业务内容被误拦截时，可补充清晰的任务说明，并保留请求 ID 和脱敏报错，联系技术支持核查。重试前先判断
- 参数、凭证或权限错误：修正后再发送，等待通常不会改变结果。
- 限流与临时服务异常：控制并发，设置退避、最大次数和总超时；响应有等待提示时参考该提示。
- 生图或已创建的视频任务：超时不代表任务没有执行，重复提交可能产生新的生成与费用。先查看已有用量或任务状态。
- SDK 自带重试与业务外层重试可能叠加，配置前先核对各层。
为什么消耗了 token 却没有正文？
推理模型可能先消耗输出预算进行思考。预算过小、生成截断或仅返回工具调用时，不能仅凭空的message.content 判断请求失败。
- 查看响应
finish_reason、工具调用字段与usage。 - 如果因长度限制结束，核对模型允许的输出预算和推理设置。
- 如果返回工具调用，按函数调用流程执行并回传结果。
- 仍无法定位时，保留响应 ID 和脱敏响应，见排查材料。
max_tokens；提高预算前先结合用量和结束原因判断，重新请求可能产生额外费用。