OpenAI API 快速开始:完成第一次 Responses 请求
这一页只完成一个目标:从服务端发出第一次 OpenAI API 请求,并在终端看到文本结果。示例使用 Node.js 和官方 JavaScript SDK,不包含网页界面;先把最小链路跑通,后续章节再加入多轮对话、工具和流式输出。
1、准备项目与密钥
创建空目录并安装 SDK:
npm init -y
npm install openai
npm pkg set type=module
在 OpenAI 平台创建 API Key,然后仅在当前 PowerShell 会话中设置环境变量:
$env:OPENAI_API_KEY="你的_API_Key"
真实密钥不能写进前端代码、截图或 Git 仓库。官方 SDK 会自动读取 OPENAI_API_KEY,因此代码中不需要出现密钥字符串。
2、发送第一次请求
新建 app.js:
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: process.env.OPENAI_MODEL || "gpt-5.6",
input: "用三句话解释什么是 API。",
});
console.log(response.output_text);
运行 node app.js。成功时,终端会打印模型生成的文本。本文在 2026 年 7 月 13 日核验官方最新模型指南时使用 gpt-5.6;模型建议会变化,所以生产项目应通过环境变量管理名称,并在升级前重新评测。
3、常见错误怎么排查
- 出现鉴权错误:确认变量名是
OPENAI_API_KEY,并在同一个终端会话运行脚本。 - 提示模型不可用:检查账号项目可用模型,不要把教程中的模型名视为永久值。
output_text为空:先记录响应状态,再查看output中是否包含拒绝、工具调用或错误项目。- 请求在浏览器失败:不要把密钥移到浏览器;应建立自己的服务端接口转发请求。
第一次调用成功后,下一页先理解平台中的模型、请求和工具分别承担什么职责,再决定应用架构。