ChatGPT API调用实战：从零开始构建智能对话应用

1次阅读

没有评论

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

作为开发者，在初次使用 ChatGPT API 时经常会遇到以下几个典型问题：

认证流程复杂：不熟悉 OpenAI 的认证机制，容易在 API 密钥获取和请求头配置上出错
参数配置不清晰：对于 temperature、max_tokens 等关键参数的作用和取值区间把握不准
响应处理效率低：直接处理原始 JSON 响应，缺乏结构化解析和错误处理机制

这些问题会导致开发效率低下，API 调用不稳定，甚至产生不必要的费用。

主流编程语言都可以调用 ChatGPT API，各有优劣：

Python（推荐）
优势：丰富的 HTTP 请求库(requests)、完善的 JSON 处理、清晰的代码结构
适合：快速原型开发、数据处理密集型应用
Node.js
优势：异步处理天然适合聊天场景、生态丰富
适合：实时交互应用、服务端渲染
Java
优势：类型安全、企业级应用支持
适合：大型系统集成

本文以 Python 为例，因为其学习曲线平缓，且是 AI 领域的主流语言。

登录 OpenAI 平台，在 API Keys 页面：

点击 ”Create new secret key”
妥善保存生成的密钥（只会显示一次）
建议设置使用限额和密钥描述

重要安全提示：

永远不要将 API 密钥直接写在代码中
不要将密钥提交到版本控制系统
建议使用环境变量或密钥管理服务

ChatGPT API 使用 Bearer Token 认证方式，需要设置以下 HTTP 头：

headers = {"Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

最关键的请求参数包括：

model：指定使用的模型，如 ”gpt-3.5-turbo”
messages：对话消息列表，每个消息包含 role 和 content
temperature：控制创造力的浮点数（0-2）
max_tokens：限制响应长度

典型配置示例：

payload = {
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}],
    "temperature": 0.7,
    "max_tokens": 150
}

API 返回的 JSON 结构包含：

choices：生成的结果数组
usage：本次调用的 token 消耗统计
created：时间戳

应该处理的状态码：

200：成功
400：错误请求
401：认证失败
429：速率限制
500：服务器错误

以下是符合 PEP8 规范的完整示例：

import os
import requests
from dotenv import load_dotenv

# 加载环境变量
load_dotenv()
API_KEY = os.getenv("OPENAI_API_KEY")
API_URL = "https://api.openai.com/v1/chat/completions"


def chat_with_gpt(prompt):
    """与 ChatGPT 交互的封装函数"""
    headers = {"Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }

    payload = {
        "model": "gpt-3.5-turbo",
        "messages": [{"role": "user", "content": prompt}],
        "temperature": 0.7,
        "max_tokens": 150
    }

    try:
        response = requests.post(API_URL, headers=headers, json=payload)
        response.raise_for_status()  # 检查 HTTP 错误

        data = response.json()
        return data["choices"][0]["message"]["content"]

    except requests.exceptions.RequestException as e:
        print(f"请求出错: {e}")
        return None
    except KeyError:
        print("响应格式异常")
        return None


if __name__ == "__main__":
    user_input = input("你的问题:")
    answer = chat_with_gpt(user_input)
    print(f"AI 回复: {answer}")