请求格式错误

如果你收到 400、参数无效、模型无效或请求体格式错误，先检查请求结构，而不是先怀疑平台本身。

常见原因

1. 接口路径错了

推荐优先验证：

POST /v1/chat/completions

2. JSON 结构不对

例如：

• messages 不是数组
• role / content 字段缺失
• 外层字段拼写错误

3. 模型名称无效

模型名不是随便写一个看起来像的字符串就能成功，必须使用平台当前可用的模型名。

4. 参数组合不兼容

某些模型、客户端和请求方式之间，可能不支持某些字段组合。

最小正确示例

{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "user", "content": "你好"}
  ]
}

排查顺序

1. 先删掉所有非必要参数
2. 保留最小请求体
3. 验证成功后再逐步把业务参数加回来

这比一边怀疑 SDK、一边猜平台兼容性要快得多。