Python 调用 ChatGPT API 入门与实战

前言

ChatGPT 技术的普及为开发者提供了强大的自然语言处理能力。本文将详细介绍如何在 Python 项目中集成 ChatGPT 服务，实现自动化的文本生成与对话功能。

环境准备

1. 安装依赖

使用 pip 安装 openai 库：

pip install openai

2. 获取 API 密钥

访问 OpenAI 官方网站注册账号，并在控制台创建新的 API Key。请妥善保管密钥，避免泄露。

代码实现

以下示例展示了如何初始化客户端并发送请求。建议将 API Key 存储在环境变量中以提高安全性。

import os
from openai import OpenAI

# 从环境变量读取密钥，避免硬编码
api_key = os.getenv("OPENAI_API_KEY")
client = OpenAI(api_key=api_key)

try:
    completion = client.chat.completions.create(
        model="gpt-3.5-turbo",
        messages=[
            {"role": "user", "content": "你好，请介绍一下 Python"}
        ],
        max_tokens=1024
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"发生错误：{e}")

参数说明

• model: 指定使用的模型版本，如 gpt-3.5-turbo。
• messages: 对话历史列表，包含角色（system/user/assistant）和内容。
• max_tokens: 限制生成的最大 token 数。
• temperature: 控制随机性，值越高输出越多样。

常见问题

1. 认证失败

如果返回 401 错误，通常是因为 API Key 无效或过期。请检查密钥是否正确复制，并确保账户余额充足。

2. 网络超时

由于服务位于海外，国内访问可能需要配置代理。确保网络连接稳定。

3. 内容过滤

部分敏感话题可能触发安全策略导致无法生成。请调整提示词以符合规范。

结语

通过以上步骤，您可以快速在 Python 应用中接入 ChatGPT 能力。后续可根据业务需求扩展更多功能，如多轮对话、函数调用等。