Node.js 调 OpenAI 兼容接口，为什么 Python 能用但 Node 不行

同一个 Key、同一个地址，Python 正常而 Node.js 报错，通常说明差异出在 SDK 版本、环境变量、代理、TLS 或 baseURL 写法。两种 SDK 的参数命名并不完全一样。

一、为什么会出现这个问题

• SDK 版本、接口版本、模型名称和示例代码并不匹配。
• Python 的 base_url 与 Node.js 的 baseURL 等配置写法不同。
• 旧教程仍使用旧接口，而当前服务只实现其中一部分。
• 异常被 SDK 包装后，只看最后一行会丢掉响应状态码和原始响应体。

二、推荐的排查顺序

1. 锁定版本和接口

记录 Node/Python、SDK 版本、base URL、模型名和 endpoint。不要把 2023 年旧博客的参数直接复制到当前 SDK。

2. 先跑最小请求

只保留 model + 简单 input。最小请求成功后，再逐个加 stream、tools、JSON schema 等复杂能力。

3. 保留原始响应

遇到异常时记录 status code、content-type、body 前几百字符和 request id，避免 SDK 把关键信息包装掉。

三、可以直接复制的排查示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});

const response = await client.responses.create({
  model: process.env.OPENAI_MODEL,
  input: "写一个 Node.js Hello World",
});
console.log(response.output_text);

四、使用建议

跨语言对比时固定 URL、Key、model、prompt 四个变量，只改变客户端实现。这样才容易找到差异。