ChatGPT新手开发者指南：从API调用到实战避坑

1次阅读

共计 1733 个字符，预计需要花费 5 分钟才能阅读完成。

ChatGPT API 的核心能力边界：1) 支持多轮对话的文本生成；2) 可处理约 4096 个 token 的上下文窗口；3) 能理解结构化指令但无法执行物理操作。

安装官方 SDK（推荐 Python 3.8+ 环境）：

pip install openai

登录 OpenAI 账户获取 API 密钥
安全存储方式（二选一）：
环境变量（推荐）：
```
export OPENAI_API_KEY='sk-...'
```

代码内配置（仅用于测试）：

import openai
openai.api_key = 'sk-...'  # 实际项目请勿硬编码

model: 推荐使用gpt-3.5-turbo（性价比最优）
temperature: 0- 2 之间，值越高随机性越强
max_tokens: 控制响应长度（注意：输入 + 输出≤4096）

import openai
from typing import Dict, Optional

def chat_completion(prompt: str) -> Optional[Dict]:
    try:
        response = openai.ChatCompletion.create(
            model="gpt-3.5-turbo",
            messages=[{"role": "user", "content": prompt}],
            temperature=0.7,
            max_tokens=500
        )
        return response.choices[0].message.content
    except openai.error.AuthenticationError:
        print("认证失败，请检查 API 密钥")
    except openai.error.RateLimitError:
        print("触发速率限制")
    except Exception as e:
        print(f"未知错误: {str(e)}")
    return None

使用 Server-Sent Events(SSE)技术实现实时输出：

def stream_response(prompt: str):
    try:
        stream = openai.ChatCompletion.create(
            model="gpt-3.5-turbo",
            messages=[{"role": "user", "content": prompt}],
            stream=True
        )

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

    except KeyboardInterrupt:
        print("\n 用户中断")

中文 1 个 token≈2 个字符

可通过 tiktoken 库精确计算：

import tiktoken
encoder = tiktoken.encoding_for_model("gpt-3.5-turbo")
token_count = len(encoder.encode(prompt_text))

保存完整对话历史会快速消耗 token
推荐方案：
只保留最近 3 轮对话
对历史消息进行摘要压缩

实现指数退避重试机制：

import time
from openai.error import RateLimitError

def robust_request(prompt, max_retries=3):
    for i in range(max_retries):
        try:
            return chat_completion(prompt)
        except RateLimitError:
            wait_time = 2 ** i  # 指数退避
            time.sleep(wait_time)
    raise Exception("超过最大重试次数")