使用官方SDK在本地环境中接入OpenAI API的技术实践

最新推荐文章于 2025-10-10 07:47:24 发布

原创最新推荐文章于 2025-10-10 07:47:24 发布 · 512 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#ai

后端专栏收录该内容

222 篇文章

订阅专栏

使用官方SDK在本地环境中接入OpenAI API的技术实践

本文将详细介绍如何在本地开发环境中通过官方SDK安全高效地调用OpenAI API，内容覆盖环境变量配置、SDK安装及基础API调用流程，旨在为技术开发人员提供完整的编程实现参考。

1. 环境变量配置

在使用OpenAI API前，需首先创建并配置API密钥。建议将密钥设置为系统环境变量，以便SDK自动读取，提高密钥安全性和代码可移植性。

1.1 生成API密钥

请在OpenAI管理后台生成API密钥，并安全保存。切勿将密钥明文嵌入代码仓库。

1.2 设置环境变量（以macOS和Linux为例）

在终端中执行如下命令，将密钥导出为环境变量：

# 将your_api_key_here替换为实际的API密钥
export OPENAI_API_KEY=your_api_key_here

此配置确保官方SDK能自动识别API密钥，无需在代码中硬编码。

2. 官方SDK安装与使用

OpenAI官方为多种语言提供SDK。本文以Node.js环境下的TypeScript/JavaScript SDK为例，演示基础流程。

2.1 安装SDK

可使用npm等包管理工具安装SDK：

npm install openai

2.2 编写并执行API请求代码

创建文件example.mjs，并编写如下示例代码：

// 导入OpenAI官方SDK
import OpenAI from "openai";

// 实例化OpenAI客户端，SDK会自动从环境变量读取API密钥
const client = new OpenAI();

// 构造并发送基础API请求，调用gpt-4.1模型生成文本
const response = await client.responses.create({
    model: "gpt-4.1", // 指定模型版本
    input: "Write a one-sentence bedtime story about a unicorn." // 输入内容，可根据实际需求调整
});

// 输出返回的文本结果
console.log(response.output_text);

代码说明：
- SDK通过环境变量自动获取API密钥，无需在代码中明文配置。
- model参数用于指定需要调用的模型版本。
- input参数为用户输入内容，可以灵活扩展。
- 返回结果通过response.output_text获取。

在命令行中执行如下命令运行脚本：