用 OpenAI SDK 接入 BigModel.io：从 API Key 到第一次调用用 OpenAI SDK 接入

用 OpenAI SDK 接入 BigModel.io：从 API Key 到第一次调用

这篇记录一个最小接入流程：使用 OpenAI SDK，通过 BigModel.io 调用大模型 API。

适合场景：

AI 应用原型
Agent / RAG 项目
企业内部 AI 工具
想先用小流量验证模型调用稳定性的项目

1. 准备 API Key

进入 BigModel.io API 平台：

https://ai.bigmodel.io

登录后创建 API Key，并保存到环境变量：

export BIGMODEL_API_KEY="你的 API Key"

2. 安装 SDK

npm install openai

3. 发起第一次调用

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.bigmodel.io/v1",
  apiKey: process.env.BIGMODEL_API_KEY
});

const response = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [
    {
      role: "user",
      content: "请用三句话解释什么是 RAG。"
    }
  ]
});

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

4. 开发者应该重点看什么

接入模型 API 时，不建议只看一次调用是否成功。更重要的是持续观察：

请求是否稳定返回。
错误状态是否清楚。
调用记录是否能查到。
token 和费用是否可追踪。
同一个 prompt 在不同模型上的效果差异。

5. 为什么要保留调用记录

很多 AI 应用上线后会遇到三个问题：

成本不知道花在哪里。
失败请求不知道是谁触发的。
不同模型效果无法复盘。

所以调用记录不是锦上添花，而是线上应用的基础设施。

6. 关于 BigModel.io

BigModel.io 是面向开发者和企业技术团队的大模型 API 接入平台，当前提供 API Key、按量计费、调用记录、余额查询和模型价格信息。

目前已支持 GPT，更多大模型陆续接入中。

入口：

https://ai.bigmodel.io