ChatGPT API接入实战：从认证流程到最佳实践

1次阅读

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

接入 ChatGPT API 时，开发者常遇到以下问题：

401 认证失败：API 密钥无效或过期，请求头配置错误
速率限制 /Rate Limit：免费账号每分钟 3 次请求限制易触发 429 错误
流式响应中断：网络波动导致 Chat Completion Stream 模式断开连接
上下文丢失：多轮对话时未正确处理历史消息，导致会话逻辑断裂

特性	REST API	Chat Completion Stream
响应速度	一次性返回完整结果	实时流式返回(tokens 逐块接收)
内存占用	需等待完整响应	可边接收边处理
适用场景	短文本生成	长文本 / 实时交互
错误恢复	需完全重试	可断点续传

API 密钥申请：
登录 OpenAI 平台 → 点击 ”API Keys” → 创建新密钥
建议为不同环境（开发 / 生产）分配独立密钥
密钥存储方案：
开发环境：使用 dotenv 管理环境变量
生产环境：AWS Secrets Manager 或 HashiCorp Vault

Python 示例（HMAC-SHA256）：

import hmac
import hashlib

def generate_signature(secret, payload):
    return hmac.new(secret.encode(), 
        payload.encode(), 
        hashlib.sha256
    ).hexdigest()

Session 维护策略：
使用唯一 UUID 标识会话
持久化存储消息历史（Redis/MongoDB）
设定上下文窗口大小（如最近 10 轮对话）

import openai
import asyncio
from tenacity import retry, wait_exponential

@retry(wait=wait_exponential(multiplier=1, min=4, max=10))
async def chat_completion(messages):
    response = await openai.ChatCompletion.acreate(
        model="gpt-3.5-turbo",
        messages=messages,
        temperature=0.7,  # 控制创造性(0-2)
        top_p=0.9,       # 核采样阈值(0-1)
        stream=True
    )
    async for chunk in response:
        print(chunk.choices[0].delta.get("content", ""))

const {Configuration, OpenAIApi} = require("openai");

const retryChat = async (messages, attempt = 1) => {
  try {
    const res = await openai.createChatCompletion({
      model: "gpt-3.5-turbo",
      messages
    });
    return res.data.choices[0].message;
  } catch (err) {if (attempt > 3) throw err;
    await new Promise(r => setTimeout(r, 2 ** attempt * 1000));
    return retryChat(messages, attempt + 1);
  }
};