OpenAI API 接入完整教程

Responses API 实战 · GPT-5.2 价格对比 · 国内访问方案 · 2026 最新版

一、四步跑通第一个请求

1. 拿到 API Key。登录 OpenAI 平台 → API Keys → 创建密钥。把 Key 存进环境变量（OPENAI_API_KEY），绝不写进前端代码或公开仓库。
2. 选接口形态。新项目用 /v1/responses（Responses API）；已有 Chat Completions 代码可暂不迁移，长期共存。
3. 选模型。复杂任务用 gpt-5.2；常规任务 gpt-5.1 / gpt-5；高频简单任务用 gpt-5.2-mini / gpt-5.2-nano。下方价格表可对照选型。
4. 成本控制上线前必做。开启提示词缓存（缓存输入 9 折）、限制 max_output_tokens、监控用量配额，避免意外超额。

二、Python：Responses API 第一个请求

from openai import OpenAI

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

# 方式 A：官方推荐的 Responses API（/v1/responses）
resp = client.responses.create(
    model="gpt-5.2",
    input="用一句话解释什么是大模型推理。",
)
print(resp.output_text)

# 方式 B：经典 Chat Completions（仍长期支持）
chat = client.chat.completions.create(
    model="gpt-5.2",
    messages=[{"role":"user","content":"用一句话解释什么是大模型推理。"}],
)
print(chat.choices[0].message.content)

三、Node.js：Responses API 第一个请求

import OpenAI from "openai";

const client = new OpenAI();  // 自动读取环境变量 OPENAI_API_KEY

// 方式 A：Responses API
const resp = await client.responses.create({
  model: "gpt-5.2",
  input: "用一句话解释什么是大模型推理。",
});
console.log(resp.output_text);

// 方式 B：Chat Completions
const chat = await client.chat.completions.create({
  model: "gpt-5.2",
  messages: [{ role: "user", content: "用一句话解释什么是大模型推理。" }],
});
console.log(chat.choices[0].message.content);

四、多轮对话与工具调用（Responses API）

# Responses API 原生支持多轮与 tools，无需手动拼接历史
resp = client.responses.create(
    model="gpt-5.2",
    input=[
        {"role":"user","content":"推荐三本讲大模型的入门书"},
        {"role":"assistant","content":"《动手学深度学习》《GPT 图解》《大模型技术30讲》"},
        {"role":"user","content":"把第二本展开讲讲"},
    ],
)
print(resp.output_text)

五、GPT-5.2 系列价格对比表

单位：美元 / 每百万 token（输入 / 输出）；缓存输入享约 9 折。

六、国内访问方案（合规优先）

方案 1：企业合规网络 / 境外云服务器中转

在合规的境外云节点（如阿里云国际、腾讯云国际等）部署轻量转发服务，由服务端持有 Key 代理请求，前端只连你自己的服务。本质是「自有后端代理」，最稳妥。

方案 2：Azure OpenAI（国内可商用）

通过微软 Azure OpenAI 服务（国内由世纪互联运营），使用企业资质申请，合规、可开具发票、适合生产环境。模型版本与官方对齐，调用方式兼容 OpenAI SDK（仅 base_url 与鉴权方式不同）。

方案 3：OpenAI 兼容的国内模型平替

若业务不强制用 GPT，可直接用 免费额度汇总 中的 DeepSeek / 通义 / 智谱等，接口与 OpenAI 高度兼容，改一行 base_url 即可迁移，国内访问稳定且中文更友好。

七、常见错误排查

• 401：密钥无效或过期 → 重新生成并确认环境变量已加载。
• 429：触发速率限制或额度耗尽 → 降低并发、开启缓存，或充值后重试。
• 404：模型名或 base_url 写错 → 核对官方模型 ID（如 gpt-5.2）与 endpoint 地址。
• 生产环境务必设置超时、指数退避重试与配额告警，避免雪崩。

八、常见问题

查看全部模型价格 » · 免费额度汇总 » · 通用 API 接入（OpenAI 兼容）»