OpenAI API 快速入门：文本生成与对话开发

OpenAI API 概览

OpenAI API 提供了对 GPT 系列模型的程序化访问能力，支持文本生成、对话、函数调用、图像生成、语音合成等多种功能。开发者可以通过 REST API 或官方 SDK 快速集成到应用中。

获取 API Key

1. 访问 platform.openai.com 注册/登录
2. 进入 API Keys 页面，点击 "Create new secret key"
3. 保存密钥（仅显示一次）
4. 设置环境变量：export OPENAI_API_KEY=sk-xxx

Python SDK 安装

pip install openai

基础文本生成

Chat Completions API

from openai import OpenAI

client = OpenAI()  # 自动读取 OPENAI_API_KEY

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个专业的技术顾问。"},
        {"role": "user", "content": "解释什么是大语言模型？"}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)

流式输出

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一首关于AI的诗"}],
    stream=True
)

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

函数调用（Function Calling）

让模型决定何时调用预定义的函数：

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "获取指定城市的天气",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "城市名称"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "北京今天天气怎么样？"}],
    tools=tools
)

模型选择指南

定价参考

最佳实践

• 使用 system message 设定角色和行为约束
• 善用 temperature：0=确定性输出，1=创意性输出
• 长对话使用 消息摘要 控制上下文长度
• 实现 重试机制 处理速率限制
• 敏感内容使用 moderation API 过滤