AI 大模型开发入门:使用 OpenAI API 实现 Hello World
在人工智能飞速发展的今天,掌握大模型(LLM)的基础调用能力已成为开发者的重要技能。本文将带你从零开始,配置 Python 环境并调用 OpenAI API,完成第一个'Hello World'程序,为后续深入 Prompt 工程、Agent 开发及微调打下基础。
1. 前置准备
1.1 开发环境
- 操作系统:Windows / macOS / Linux 均可
- Python 版本:建议 Python 3.10 及以上
- 编辑器:VS Code 或 PyCharm
1.2 API Key 获取
调用 OpenAI 服务需要有效的 API Key。由于网络限制,国内用户通常需要通过官方渠道或合规的代理服务商获取。请确保你的账户已充值或拥有可用的免费额度。
注意:API Key 属于敏感信息,切勿上传至公共代码仓库(如 GitHub),应通过环境变量管理。
2. 环境配置
2.1 创建项目目录
在本地创建一个英文命名的文件夹作为项目根目录,例如 openai_demo。
2.2 安装依赖库
打开终端,进入项目目录,执行以下命令安装必要的 Python 包:
pip install python-dotenv openai
python-dotenv:用于加载.env文件中的环境变量。openai:OpenAI 官方提供的 Python SDK(v1.x 版本)。
2.3 配置环境变量
在项目根目录下创建名为 .env 的文件,用于存储密钥和配置信息。
原生配置示例
如果你使用的是官方直连地址:
OPENAI_API_KEY=sk-your-api-key-here
代理配置示例
如果使用第三方代理接口,需额外指定 Base URL:
OPENAI_API_KEY=sk-your-proxy-key-here
OPENAI_BASE_URL=https://api.your-proxy.com/v1
安全提示:
.env文件应加入.gitignore中,防止密钥泄露。
3. 代码实现
新建文件 chat_hello.py,编写以下代码:
from openai import OpenAI
from dotenv import load_dotenv, find_dotenv
import os
# 加载 .env 文件到环境变量
_ = load_dotenv(find_dotenv())
# 初始化客户端
client = OpenAI(
api_key=os.getenv(),
base_url=os.getenv(, )
)
:
response = client.chat.completions.create(
model=,
messages=[
{
: ,
:
}
],
temperature=,
max_tokens=
)
response.choices:
content = response.choices[].message.content
()
:
()
Exception e:
()


