LLM基础

第2课：OpenAI API入门

📚 OpenAI API入门概述

本课是LLM应用开发课程第2课，属于LLM基础阶段。我们将深入学习OpenAI API入门的核心概念、技术实现和实战应用。

🎯 核心要点

API Key安全配置
基础API调用
三种消息角色
多轮对话ChatSession
关键参数Temperature/max_tokens
错误处理与重试
成本追踪CostTracker

📊 架构与技术全景

第2课: OpenAI API入门
├── 核心概念与原理
├── 技术实现与代码
├── 架构设计与最佳实践
├── 实战练习与验证
└── 成就解锁

🔍 API Key安全配置

API Key安全配置是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示API Key安全配置的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：API Key安全配置的核心实现正确工作

🛠 基础API调用

基础API调用是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示基础API调用的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：基础API调用的核心实现正确工作

️ 三种消息角色

三种消息角色是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示三种消息角色的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：三种消息角色的核心实现正确工作

📐 多轮对话ChatSession

多轮对话ChatSession是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示多轮对话ChatSession的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：多轮对话ChatSession的核心实现正确工作

💡 关键参数Temperature/max_tokens

关键参数Temperature/max_tokens是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示关键参数Temperature/max_tokens的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：关键参数Temperature/max_tokens的核心实现正确工作

🔧 错误处理与重试

错误处理与重试是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示错误处理与重试的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：错误处理与重试的核心实现正确工作

🚀 成本追踪CostTracker

成本追踪CostTracker是OpenAI API入门的关键环节。理解并掌握这一要点，对于构建生产级LLM应用至关重要。

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示成本追踪CostTracker的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

✅ 验证通过：成本追踪CostTracker的核心实现正确工作

📊 技术对比与选型

方案	优势	劣势	适用场景
方案A 轻量级	简单直接上手快	扩展性有限	原型验证
方案B 标准级	功能完整生态好	复杂度中等	生产环境
方案C 企业级	高性能可扩展	成本较高	大规模应用

💡 最佳实践

在实际项目中，OpenAI API入门需要根据具体需求灵活调整
从小规模验证开始，逐步扩展到生产环境
建立完善的评估体系，持续监控和优化
参考社区最佳实践，避免重复造轮子
关注API Key安全配置的最新进展和优化技巧

🏗️ 架构设计

┌──────────────────────────────────────┐
│  OpenAI API入门架构
├──────────────────────────────────────┤
│  用户层: API / SDK / CLI
├──────────────────────────────────────┤
│  业务层: API Key安全配置
├──────────────────────────────────────┤
│  数据层: 向量DB / 缓存 / 存储
├──────────────────────────────────────┤
│  基础层: LLM / 嵌入模型
└──────────────────────────────────────┘

⚠️ 常见陷阱

忽略API Key安全配置的边界条件，导致生产环境问题
过度优化单一指标，忽视整体系统平衡
缺少监控和告警，问题发现滞后
没有建立回滚机制，变更风险高

⚡ 性能考量

指标	目标值	优化手段
TTFT	< 500ms	缓存/模型选择/提示词精简
成功率	> 99%	重试机制/降级策略
成本	可控范围	语义缓存/模型路由/token控制
延迟P99	< 5s	流式输出/并行处理

🔗 与其他课程的关系

本课OpenAI API入门建立在前面课程的基础上，同时为后续内容做铺垫。

后续应用：第3课「Prompt Engineering」
本课是LLM基础阶段的关键一环

🏋️ 实战练习

构建OpenAI API入门系统

# {point} 核心实现
from openai import OpenAI
import json

client = OpenAI()

def demo():
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "你是专业的LLM应用开发助手。"},
            {"role": "user", "content": "演示OpenAI API入门完整系统的用法"},
        ],
        temperature=0.3,
    )
    return response.choices[0].message.content

result = demo()
print(f"结果: {result[:100]}...")

进阶挑战

尝试将API Key安全配置与基础API调用结合，构建更完整的解决方案。

🏆 本课成就

🏅 OpenAI API入门实践者

✅ API Key安全配置
✅ 基础API调用
✅ 三种消息角色
✅ 多轮对话ChatSession
✅ 关键参数Temperature/max_tokens

← 第1课 ≡ 目录第3课 →