Python 库 包 软件开发工具包（SDK） openai

openai 是 OpenAI 官方提供的一个 Python 软件开发工具包（SDK），用于调用其提供的各种大语言模型 API，例如：

• gpt-3.5-turbo
• gpt-4
• gpt-4-turbo
• davinci
• text-embedding-ada-002
• whisper-1（语音转文字）
• image-alpha（图像生成）

通过这个库，你可以很方便地在自己的 Python 项目中接入 OpenAI 的强大 AI 模型，实现文本生成、对话系统、翻译、摘要、代码编写、语音识别、图像生成等功能。

📦 包名称：openai

• 官方地址：https://github.com/openai/openai-python
• PyPI 地址：https://pypi.org/project/openai/
• 主要功能：
  • 提供对 GPT 系列模型的接口访问
  • 支持同步和异步调用
  • 支持流式输出（Streaming）
  • 支持图像、音频、嵌入向量等多种任务

🔐 使用前提

要使用 openai 这个 Python 包，你需要：

1. 注册 OpenAI 账号：https://platform.openai.com/
2. 获取你的 API Key（位于 API Keys 页面）
3. 安装 openai 包

🚀 安装方式

pip install openai

⚠️ 注意：如果你使用的是旧版本（如 v0.28），某些函数名和参数会不同。推荐使用最新版（当前为 v1.x）。

🧪 快速入门示例

示例1：调用 GPT-3.5 或 GPT-4 生成文本

import openai

# 设置你的 API Key
openai.api_key = "你的 API Key"

# 调用 GPT 模型
response = openai.chat.completions.create(
    model="gpt-3.5-turbo",  # 可替换为 "gpt-4" 或 "gpt-4-turbo"
    messages=[
        {"role": "system", "content": "你是一个中文助手"},
        {"role": "user", "content": "请写一篇关于人工智能的文章"}
    ]
)

# 输出结果
print(response.choices[0].message.content)

示例2：流式输出（Streaming）

import openai

openai.api_key = "你的 API Key"

response = openai.chat.completions.create(
    model="gpt-3.5-turbo",
    messages=[
        {"role": "system", "content": "你是一个幽默的中文助手"},
        {"role": "user", "content": "讲一个程序员的笑话"}
    ],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

示例3：调用 DALL·E 生成图片（需权限）

response = openai.images.generate(
    model="dall-e-3",
    prompt="一只穿着西装的猫在办公室工作",
    size="1024x1024",
    quality="standard",
    n=1
)

print(response.data[0].url)

示例4：调用 Whisper 做语音转文字（需上传音频文件）

audio_file = open("your_audio.mp3", "rb")
transcript = openai.audio.translations.create(
    model="whisper-1",
    file=audio_file
)

print(transcript.text)

⚙️ 支持的主要模型与功能

📦 常见结合使用的库

✅ 总结

🎯 推荐使用场景

• 开发中文聊天机器人
• 自动生成文章、邮件、报告等内容
• 实现语音识别与翻译
• 创建图像生成工具（如 logo 设计、插画）
• 搭建基于 GPT 的智能客服系统
• 教育领域：自动批改作业、题目解析、学习建议