Node.js
入门 · 约 8 分钟
使用 Node.js SDK 接入 OpenAI 兼容 API
OpenAI Node.js SDK 支持自定义 baseURL，适合在 Node.js 服务端、脚本或后端接口中调用 AINN API。
开始前准备
- Node.js 22 LTS 或更高版本
- 已创建 AINN API Key
- 已从模型广场确认模型名称
1
步骤 1
初始化项目并安装 SDK
下面示例使用 ES Modules。现有项目可以只执行安装命令。
Terminal
npm init -y
npm install openai
2
步骤 2
设置 API Key
生产环境应通过服务器的密钥管理或环境变量注入，不要在前端 JavaScript 中使用真实 API Key。
macOS / Linux
export AINN_API_KEY="你的 API Key"Windows PowerShell
$env:AINN_API_KEY="你的 API Key"
3
步骤 3
创建客户端并调用模型
Node.js SDK 使用 baseURL 配置兼容接口地址。模型标识请从模型广场复制。
example.mjs
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.AINN_API_KEY,
baseURL: "https://api.ainn.cc/v1",
});
const response = await client.chat.completions.create({
model: "your-model",
messages: [
{ role: "system", content: "你是一个简洁的中文助手。" },
{ role: "user", content: "给我三个学习 Node.js 的建议。" },
],
});
console.log(response.choices[0].message.content);
4
步骤 4
运行并用于服务端
运行示例确认接入成功。集成到网站时，应由自己的后端接收前端请求，再由后端安全地调用模型接口。
- 捕获 SDK 抛出的错误并返回友好提示
- 为用户请求增加鉴权、限流和内容长度限制
- 不要把上游错误对象和敏感配置原样返回给浏览器
Terminal
node example.mjs完成检查
- Node.js 终端能打印模型回复
- 调用发生在服务端而不是浏览器
- 控制台中能核对请求用量
继续完成项目接入
选择合适模型并估算实际成本
教程中的模型名只是占位符。请根据业务场景选择当前可用模型，再用真实 Token 用量估算预算。