OpenAI API 接口对接完全教程 / 01 - OpenAI API 概述

第 01 章 · OpenAI API 概述

了解 OpenAI 提供的完整 API 能力、模型体系、定价结构与能力边界，为后续对接打下基础。

1.1 OpenAI API 能力全景

OpenAI 提供的 API 可分为以下几大类：

1.2 模型体系

1.2.1 GPT 系列模型

注意：模型定价会随时间调整，请以 OpenAI 官方定价页 为准。

1.2.2 专用模型

1.3 如何选择模型

                    需要什么能力？
                         │
         ┌───────────────┼───────────────┐
         │               │               │
      文本生成         图像/音频       向量/搜索
         │               │               │
    ┌────┴────┐     ┌────┴────┐     Embeddings
    │         │     │         │
  日常任务  复杂推理  理解  生成
    │         │     │         │
  4o-mini   o3/   Vision  DALL-E
  4.1-nano  o4-mini Whisper  TTS

选型决策表：

1.4 API 调用基础

所有 API 共享统一的 REST 风格接口：

Base URL: https://api.openai.com/v1
认证方式: Bearer Token (API Key)
内容格式: application/json

基本请求示例

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请做个自我介绍"}
    ]
  }'

响应格式

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1717000000,
  "model": "gpt-4o-mini-2024-07-18",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！我是一个AI助手..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 50,
    "total_tokens": 62
  }
}

1.5 能力边界

擅长的领域

• ✅ 自然语言理解与生成
• ✅ 多语言翻译
• ✅ 代码生成与解释
• ✅ 数据分析与总结
• ✅ 创意写作
• ✅ 图像/音频理解

局限性

• ❌ 知识有时效性：训练数据有截止日期，不了解最新事件
• ❌ 可能产生幻觉：会"编造"看似合理但错误的信息
• ❌ 不擅长精确计算：复杂数学建议使用 Code Interpreter
• ❌ 无持久记忆：每次请求独立，需自行管理上下文
• ❌ 不能访问互联网：无法获取实时数据（除非通过 Function Calling 扩展）

重要约束

1.6 定价与成本控制

Token 计算规则

• 英文：约 1 token ≈ 4 个字符 / 0.75 个单词
• 中文：约 1 token ≈ 1-2 个汉字
• 图片：根据分辨率和 detail 参数计算

成本估算示例

假设每天 10,000 次 API 调用，平均每次 1000 input + 500 output tokens：

提示：善用 gpt-4o-mini 和 gpt-4.1-nano 处理简单任务，可大幅降低成本。

1.7 速率限制 (Rate Limits)

OpenAI 根据账户 Tier 分级限流：

1.8 业务场景示例

场景一：智能客服系统

• 模型：GPT-4o mini
• 日调用量：50,000 次
• 月成本估算：~$225

场景二：文档智能分析

• 模型：GPT-4.1（利用 1M 上下文）
• 单次分析 500 页 PDF
• 按需调用，成本可控

场景三：内容创作平台

• 模型：GPT-4o（质量优先）
• 结合 DALL-E 生成配图
• 流式输出提升用户体验

1.9 扩展阅读

• OpenAI 官方文档
• OpenAI 定价页
• OpenAI Cookbook
• 模型更新日志
• API 变更日志

下一章：02 - 环境搭建与配置 — 获取 API Key、安装 SDK、初始化项目。