展开本页目录
开始前准备什么
- 保留原错误与最终路径，移除 Key、Cookie 和私有内容。
- 记录准确 ID、客户端版本与发送字段名。
- 确定本次使用 Chat、Responses、Messages 还是 Images。
- 读取错误字段
- 确认协议
- 缩减请求
- 逐项恢复
- 原客户端复测
无 Key、无自动调用，目标型号仍需确认。
记录端点、错误字段、每次变更与费用。
区分字段不支持和字段值不支持
兼容网关的错误包装可能不同，不把所有 400 归因一种模型，也不把页面示例当作本站真实请求。
| 线索 | 含义 | 先检查 |
|---|---|---|
| unsupported_parameter / unknown parameter | 字段不适用于此型号或端点 | error.param 与实际字段 |
| Unsupported value / invalid value | 值或组合不接受 | 允许值、推理配置和版本 |
| max_tokens 被拒绝 | 输出字段名不兼容 | Chat / Responses 的差异 |
| 400 且 param 为空 | 网关可能重包了错误 | 脱敏错误、路径与请求编号 |
| 404 / 返回 HTML | 可能是路径或路由问题 | 重复 /v1、基础地址与代理 |
- 线索
- unsupported_parameter / unknown parameter
- 含义
- 字段不适用于此型号或端点
- 先检查
- error.param 与实际字段
- 线索
- Unsupported value / invalid value
- 含义
- 值或组合不接受
- 先检查
- 允许值、推理配置和版本
- 线索
- max_tokens 被拒绝
- 含义
- 输出字段名不兼容
- 先检查
- Chat / Responses 的差异
- 线索
- 400 且 param 为空
- 含义
- 网关可能重包了错误
- 先检查
- 脱敏错误、路径与请求编号
- 线索
- 404 / 返回 HTML
- 含义
- 可能是路径或路由问题
- 先检查
- 重复 /v1、基础地址与代理
输出预算字段按端点填写
OpenAI Chat 参考把 max_tokens 标记为 deprecated，并说明不适用于 o 系列；不能自动推导所有第三方型号都接受 max_completion_tokens，还要核对渠道与客户端转换。
当前 OpenAI 部署指南说明部分 GPT-6 工具调用依赖 Responses，推理配置也影响采样字段。先核对准确型号、工具协议与端点，删除参数不等于完成协议迁移。
| 端点 | 主要输入 | 输出预算 |
|---|---|---|
| /v1/chat/completions | messages | 按型号文档用 max_completion_tokens；旧 max_tokens 有边界 |
| /v1/responses | input | max_output_tokens |
| /v1/messages | messages 与原生字段 | max_tokens，按 provider 协议 |
| /v1/images/* | prompt / image / mask 等 | 图像参数，不套 Chat token 字段 |
- 端点
- /v1/chat/completions
- 主要输入
- messages
- 输出预算
- 按型号文档用 max_completion_tokens；旧 max_tokens 有边界
- 端点
- /v1/responses
- 主要输入
- input
- 输出预算
- max_output_tokens
- 端点
- /v1/messages
- 主要输入
- messages 与原生字段
- 输出预算
- max_tokens，按 provider 协议
- 端点
- /v1/images/*
- 主要输入
- prompt / image / mask 等
- 输出预算
- 图像参数，不套 Chat token 字段
先测试最小 Chat 结构
确认目标型号支持 Chat 后，使用下载 JSON。示例只含 model、单条 messages 和 stream=false，不含 Key，不自动请求。glm-5.3 是可在目录核对的 Chat 示例，不是任意型号的兼容保证。
- 确认允许调用后，使用自己的 Key 手动提交一次并记录费用。
- 最小请求成功而原客户端失败，比较实际发送的字段。
- 仍然失败则先检查路径、ID、权限与协议，不继续叠加参数。
chat-minimal-request.json
{
"model": "glm-5.3",
"messages": [{"role":"user","content":"仅回答 OK"}],
"stream": false
}
本站绘制的内容说明图：这是本页下载的最小请求 JSON，不是已执行响应；不保证任意型号接受同一结构。
一次恢复一个参数
不要同时换型号、路径和一组字段，否则成功也无法定位原因。默认值会变化，本页不维护声称覆盖所有型号的固定白名单。
| 顺序 | 内容 | 记录结果 |
|---|---|---|
| 1 | 该型号允许的输出预算 | 字段、数值与终止原因 |
| 2 | 流式设置 | 事件格式与结束信号 |
| 3 | 采样参数 | 是否受 reasoning 配置限制 |
| 4 | JSON 格式与 tools | schema、工具协议和回传 |
| 5 | 图片、缓存等附加字段 | 端点与型号专属支持 |
- 顺序
- 1
- 内容
- 该型号允许的输出预算
- 记录结果
- 字段、数值与终止原因
- 顺序
- 2
- 内容
- 流式设置
- 记录结果
- 事件格式与结束信号
- 顺序
- 3
- 内容
- 采样参数
- 记录结果
- 是否受 reasoning 配置限制
- 顺序
- 4
- 内容
- JSON 格式与 tools
- 记录结果
- schema、工具协议和回传
- 顺序
- 5
- 内容
- 图片、缓存等附加字段
- 记录结果
- 端点与型号专属支持
本站绘制的内容说明图：保持型号和路径不变，每次只恢复一个字段组，才能定位不支持的参数。
UI 留空，不一定没有发送参数
- Flowise、n8n 等可能发送默认 Temperature、Max Tokens 或流式设置，检查真实字段。
- AnythingLLM 输出字段键设置取决于应用版本，先核对源码与上游要求。
- 确定性 400 排查关闭生成自动重试，各层 SDK 和节点设置都要检查。
- 共享记录仅保留脱敏元数据，不复制 Authorization、Cookie、私有提示词或敏感查询参数。
回到原任务，保留全部尝试
最小文字请求仅证明这一份连接与参数可用，恢复工具、图片或 JSON 后仍需验收。超时不确定是否完成时，先查服务日志与任务。
400 不证明所有平台都无扣费，空回答也不等于零 token。失败、未知和修复后的请求全部记录，实际费用回查控制台。
怎样确认已经完成
- 保存错误字段、最终路径和准确型号。
- 最小与原客户端请求有可比较记录，一次只改一个字段。
- 工具、流式和图像独立验收。
- 全部尝试与未知结果保留，没有自动反复生成。
常见问题
把 temperature 改成 0 就行吗？
字段完全不支持时需移除；值或推理组合不支持时按准确型号调整。先看 error.param 和模型文档。
max_tokens 都换成 max_completion_tokens 吗？
不是。具体 Chat 型号与兼容渠道有要求，Responses 使用 max_output_tokens，先确定协议。
换 Key 能修复参数错误吗？
确定性参数错误通常需要修改请求。鉴权或权限问题先看相应证据，不把所有 400 当作 Key 失效。