Python 开发 OpenAI API 应用指南
OpenAI 提供了强大的 AI 模型接口,开发者可以通过 API 快速集成自然语言处理、代码生成及图像创作能力。本文将使用 Python 演示如何接入 OpenAI API,实现文本生成、代码生成和图像生成的基本功能。
1. 获取 API 密钥
在使用 API 之前,需要登录 OpenAI 账户并生成 API Key。
- 访问 OpenAI 官网并登录。
- 进入 API Keys 管理页面。
- 点击 Create new secret key 生成密钥。
- 重要提示:API Key 仅显示一次,请妥善保存。建议将其设置为环境变量,避免硬编码在代码中。
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
2. 安装依赖库
通过 pip 安装官方 OpenAI 包:
pip install openai
3. 文本生成 (Text Generation)
文本生成适用于情感分析、自动对话、摘要等场景。主要使用 Completion 端点。
代码示例
以下示例演示如何使用 GPT-3 模型进行情感判断:
import os
import openai
openai.api_key = os.getenv("OPENAI_API_KEY")
prompt = """
Decide whether a Mike's sentiment is positive, neutral, or negative.
Mike: I don't like homework!
Sentiment:
"""
response = openai.Completion.create(
model="text-davinci-003",
prompt=prompt,
max_tokens=100,
temperature=0
)
print(response.choices[0].text.strip())
参数说明
- model: 模型 ID,如
text-davinci-003。 - prompt: 触发指令,支持中英文。
- max_tokens: 生成内容的最大 token 数。
- temperature: 采样策略。接近 0 输出确定性强,接近 1 更具创造性。
返回结果示例
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"logprobs": null,
"text": "Negative"
}
],
...
}
4. 代码生成 (Code Generation)
利用 Codex 模型,可以将自然语言注释转化为可执行代码,或优化现有代码逻辑。
代码示例
生成 Python 代码以创建上海温度数组:
import os
import openai
openai.api_key = os.getenv("OPENAI_API_KEY")
response = openai.Completion.create(
model="code-davinci-002",
prompt="\nCreate an array of weather temperatures for Shanghai\n",
temperature=0,
max_tokens=256,
top_p=1,
frequency_penalty=0,
presence_penalty=0
)
print(response.choices[0].text.strip())
生成代码效果
import numpy as np
def create_temperatures(n):
"""
Create an array of weather temperatures for Shanghai
"""
temperatures = np.random.uniform(low=14.0, high=20.0, size=n)
return temperatures
5. 图像生成 (Image Generation)
使用 DALL-E 模型根据文本描述生成图像。细节越丰富,生成结果越符合预期。
代码示例
import openai
response = openai.Image.create(
prompt="A fluffy white cat with blue eyes sitting in a basket of flowers, looking up adorably at the camera",
n=1,
size="1024x1024"
)
image_url = response['data'][0]['url']
print(image_url)
6. 错误处理与最佳实践
在实际开发中,网络波动或配额限制可能导致请求失败,建议添加异常处理机制。
try:
response = openai.Completion.create(...)
except openai.error.Timeout:
print("请求超时")
except openai.error.RateLimitError:
print("达到速率限制")
except Exception as e:
print(f"发生错误:{e}")
此外,注意控制 max_tokens 以节省成本,并在生产环境中严格保护 API Key,不要提交到公共代码仓库。
总结
本文介绍了基于 Python 调用 OpenAI API 的核心流程,涵盖了文本、代码和图像三种生成模式。通过合理配置参数和处理异常,开发者可以高效构建 AI 应用原型。更多高级用法请参考官方文档。

