OpenAI API 快速入门

最后更新：2026-08-12· 16 分钟阅读

🚀 快速通道

ChatGPT 国内版：点击直达↗
稳定镜像站：打开镜像↗
官方 ChatGPT：chatgpt.com ↗

OpenAI API 快速入门

更新时间：2026-08-12

导读

OpenAI API 让你把 GPT 系列模型接入网站、脚本、客服或内部工具。本文从 Platform 账户到第一条 HTTP 请求，覆盖 Key 管理、Responses / Chat Completions 双形态示例、SDK 调用、常见错误与上线前安全检查。端点、model ID、字段名以官方 Quickstart 为准——OpenAI 可能主推 Responses API，同时保留 Chat Completions 供存量代码。

API 和 ChatGPT 网页有什么不同？

维度	chatgpt.com	OpenAI API
使用方式	浏览器对话	HTTP / 官方 SDK
计费	ChatGPT 订阅	按 token 用量
集成	人工交互	可嵌入产品流程
密钥	账户登录	API Key（需保密）

选型： 人机聊天用网页（或本站 Chat 体验入口）；自动化、批处理、产品功能用 API。

准备账户与 API Key

登录 OpenAI Platform。
在 API keys 创建 Key；立即复制，页面可能不再完整显示。
为 Key 标注用途（如 dev-bot / prod-summarizer），便于泄露后轮换。
在 Billing 开通付费并设置用量/预算告警（若控制台提供）。

# Linux / macOS
export OPENAI_API_KEY="sk-..."

# Windows PowerShell
$env:OPENAI_API_KEY="sk-..."

控制台各区域说明见 Platform 概览。

第一条 API 调用

以下展示请求形状；gpt-4o-mini 等为示例 model ID，请在对照文档后替换。

Responses API（新项目先查 Quickstart 是否推荐）

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "用三句话解释什么是 RAG"
  }'

Chat Completions（教程与存量代码常见）

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是简洁的技术助手。"},
      {"role": "user", "content": "用三句话解释什么是 RAG"}
    ]
  }'

Python SDK 示例

# pip install openai  # 版本以官方文档为准
from openai import OpenAI

client = OpenAI()  # 读取 OPENAI_API_KEY 环境变量

resp = client.chat.completions.create(
    model="gpt-4o-mini",  # 示例 ID，请查文档更新
    messages=[{"role": "user", "content": "用三句话解释什么是 RAG"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

Node.js SDK 示例

// npm install openai  // 版本以官方文档为准
import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini", // 示例 ID，请查文档更新
  messages: [{ role: "user", content: "用三句话解释什么是 RAG" }],
});
console.log(resp.choices[0].message.content);
console.log(resp.usage);

若 SDK 提供 client.responses.create(...)，以官方 Quickstart 选择 Completions 或 Responses。

读懂响应与用量

成功响应含生成文本与 usage（prompt / completion tokens）。从第一天就日志化：

字段	用途
`usage.prompt_tokens`	输入成本
`usage.completion_tokens`	输出成本
响应 `id` 或头 `x-request-id`	工单排查

价格参考：openai.com/api/pricing

模型怎么选？

场景	倾向	验证方式
客服短回复	较小/较快档位	延迟 P95、满意度
长文档摘要	长上下文档	漏项率人工抽检
复杂推理	较强档位	样例集准确率
高 QPS 批处理	成本优化档	账单 + 限流

用同一批真实输入对比两个 model ID 再定默认值。详见文本生成指南。

计费、限流与监控

Token：输入 + 输出都计费；system 与检索上下文占输入 token。
Rate limit：429 时应退避重试，勿打满并发。
监控：记录 model、latency、token、HTTP 状态；对 5xx/429 设告警。

常见 HTTP 错误

状态码	常见含义	处理
401	Key 无效或未传	检查 `Authorization` 与环境变量
429	限流	指数退避；申请提额或降 QPS
400	请求体字段错误	对照 API reference 的 model / messages
500+	服务端异常	有限重试 + 查 status.openai.com

安全清单（上线前必查）

Key 仅存在于服务端环境变量或密钥管理器
禁止把 Key 写进前端、移动 App、公开 GitHub
对用户输入做长度限制与 PII 过滤（按合规要求）
日志脱敏：不记录完整密码、卡号、健康数据
定期轮换 Key；离职流程包含吊销
dev / staging / prod 使用不同 Key

可复制 system + user 模板

[System]
你是企业知识库助手。只根据提供的 context 回答。
若 context 不足，回答「资料中未提及」并列出需要补充的信息。
不得编造链接或法规条文。

[User]
context:
"""
[粘贴脱敏段落]
"""
问题：[用户问题]

Prompt 体系化见 Prompt Engineering 指南。

常见问题

API Key 泄露了怎么办？

立即在 Platform 吊销该 Key，创建新 Key，并排查 Git 历史、CI 日志、前端 bundle。

ChatGPT Plus 包含 API 额度吗？

不包含。API 在 Platform 单独计费。

应该用 Responses 还是 Chat Completions？

以文档 Quickstart 为准。新项目跟随官方推荐；旧项目查阅迁移说明，见 API 开发指南与 Responses API 指南。

国内服务器能调 API 吗？

取决于网络与账户地区政策。API 在服务端调用，不依赖本地浏览器；合规与支付查阅官方说明。

和 Claude API 能共用一层抽象吗？

字段不同，需分别适配；可用 gateway 统一对外，底层仍按各厂商文档序列化。对比：Claude API 快速开始。

官方资源

下一步阅读

行动路径

今天：在测试环境跑通一条 API 调用并打印 usage。明天：把 Key 迁入环境变量，删除代码里的明文。本周：用 10 条真实问题建立基准集，再选默认 model 与生产化清单。

导读