Skip to content
进阶阅读时长 20 分钟·

用 OpenAI API 构建你的第一个 AI 应用

理解了原理,接下来动手写代码。这篇教程以 Node.js 为例,带你用 OpenAI API 发送第一个对话请求,并了解流式输出、成本与错误处理等生产细节。

作者:AI Resource Hub

准备工作

首先在 OpenAI 平台注册并创建一个 API Key,然后把它保存到环境变量中,切勿硬编码进代码或提交到仓库。

export OPENAI_API_KEY="sk-..."

安装 SDK

使用官方的 Node.js SDK 可以最快上手:

npm install openai

发送第一个对话请求

下面的代码向 gpt-4o-mini 发送一条消息并打印回复。messages 数组承载对话历史,role 可以是 system、user 或 assistant。

import OpenAI from 'openai';

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

const res = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [
    { role: 'system', content: '你是一个乐于助人的助手。' },
    { role: 'user', content: '用一句话介绍大语言模型。' },
  ],
});

console.log(res.choices[0].message.content);

使用流式输出

对话类应用通常需要“逐字打印”的效果,开启 stream 即可边生成边接收,显著改善体验。

const stream = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: '写一首关于春天的短诗' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

成本与错误处理

API 按 token 计费,务必设置合理的 max_tokens 并监控用量;选择更小的模型(如 mini 系列)能大幅降低成本。

网络请求可能超时或限流,生产环境要加上重试、超时和异常捕获,并对用户输入做校验与内容审核。

OpenAIAPI应用开发Node.js

相关教程