OpenAI API 购买与首次调用教程（2026最新，适合开发者）
从 OpenAI Platform 账号、Billing 付款、API Key 创建到使用官方模型 ID gpt-5.5 完成首次调用
BLUF 摘要（点开查看）
这篇教程用 6 个步骤说明 OpenAI GPT API 如何注册、开通、获取 API Key 并完成首次接入；先确认代理访问、支付方式、额度限制，再把 Key 安全保存到环境变量或工具配置中。
教程概览
准备 OpenAI Platform 账号
OpenAI API 和 ChatGPT 订阅是两套计费体系。先确认你能登录 Platform，而不是只登录 ChatGPT 网页。
点击位置：浏览器访问 platform.openai.com → 登录 → 进入 Dashboard 或 Project 页面
完成后看到：能正常进入 OpenAI Platform 控制台，并看到当前 Project
- 如果页面打不开，先检查代理和 DNS
- 如果登录反复验证，保持同一网络节点，不要频繁切换 IP
- 如果看不到 Project，确认账号是否加入了正确组织
- 访问 OpenAI Platform：platform.openai.com
- 使用邮箱、Google 或 Microsoft 账号登录
- 确认当前 Project 正确，团队账号要确认自己有创建 API Key 和查看 Billing 的权限
- 国内网络环境通常需要稳定代理，避免注册、支付或请求中途超时
开通 Billing 并确认 API 额度
没有 Billing 或余额不足时，即使 API Key 正确，也会出现 insufficient quota。先把计费状态确认清楚。
点击位置：Platform → Billing / Usage → Add payment method 或设置预算提醒
完成后看到：Billing 状态正常，Usage 页面能显示可用额度或付款方式
- 支付失败时检查卡片是否支持国际支付
- 账单地址和支付信息要保持一致
- 如果提示额度不足，先处理 Billing 再排查代码
- 进入 Billing 或 Usage 页面查看当前计费状态
- 添加可用的付款方式，通常需要支持国际支付的银行卡
- 团队或企业账号要确认当前 Project 可以使用该付款方式
- 正式接入前先设置用量上限或预算提醒，避免测试脚本误跑高成本任务
创建并安全保存 API Key
API Key 只会完整显示一次，创建后立刻复制到安全位置。
点击位置：Platform → API Keys → Create new secret key → 命名 → Create
完成后看到：页面显示一串以 sk- 开头的密钥，并且你已安全保存
- 如果按钮不可用，检查当前 Project 权限
- 如果 Key 忘记复制，删除后重新创建
- 如果 Key 泄露，立即撤销并重新生成
- 进入 API Keys 页面
- 点击 Create new secret key，为密钥按项目或用途命名
- 复制完整 Key，保存到密码管理器、.env 或系统环境变量
- 为不同项目创建不同 Key，方便后续单独撤销和追踪用量
写入环境变量并安装 SDK
本地开发建议用 .env 或系统环境变量保存 Key，代码只读取变量，不硬编码密钥。
点击位置：终端运行 pip install openai python-dotenv，项目根目录创建 .env 文件
完成后看到：本地程序能读取 OPENAI_API_KEY 环境变量
- 变量名必须是 OPENAI_API_KEY
- 修改 .env 后重启终端或开发服务
- 确认 .env 没有被提交到 Git
- 安装 openai 和 python-dotenv
- 创建 .env 文件并写入 OPENAI_API_KEY
- 确认 .env 已加入 .gitignore
- 不要在浏览器前端直接调用 OpenAI API，避免 Key 暴露
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx用 Python 调用官方 GPT-5.5
第一次测试只做最小请求，使用官方模型 ID gpt-5.5；如果你看到 GPT-5.5D / gpt-5.5d，应先要求来源，因为 OpenAI 官方文档当前未列出这个模型 ID。
点击位置：终端运行 python test_openai.py
完成后看到：Python 脚本成功打印模型回复，无 401、403、404、429 或 quota 报错
- 401 多数是 Key 无效或环境变量没生效
- 403 检查 Project、组织和模型权限
- 404 检查模型名称是否正确
- 429 降低并发或等待限流恢复
- insufficient quota 回到 Billing 检查额度
- 从 .env 读取 OPENAI_API_KEY
- 使用 OpenAI 官方 SDK 创建 client
- 先用短 prompt 测试，不要一开始上传大文件或跑高并发
- 能打印模型回复就说明基础接入成功
from dotenv import load_dotenv
from openai import OpenAI
load_dotenv()
client = OpenAI()
response = client.responses.create(
model="gpt-5.5",
input="请用一句话说明 OpenAI API 已经接入成功。"
)
print(response.output_text)按任务选择模型并控制成本
跑通后再根据任务切换模型，不要所有任务都默认使用最贵模型。
点击位置：Platform → Docs / Models / Usage 页面查看模型、价格和用量
完成后看到：根据任务选择了模型，并能在 Usage 中看到调用记录
- 模型名要以官方文档和控制台为准
- 如果模型不可用，检查 Project 权限
- 如果成本异常，先降低上下文长度和输出长度
- GPT-5.5：官方最新旗舰模型，适合复杂专业工作、编码、长上下文检索、工具型 Agent 和生产级助手
- GPT-5.5 pro：更高计算量版本，适合更难的 Responses API 异步任务；请求可能需要数分钟，建议配合 background mode
- 标准价格：gpt-5.5 在 <272K 上下文下为 $5 输入 / $30 输出每百万 token（约 ¥36/¥218）；gpt-5.5-pro 为 $30 / $180 每百万 token（约 ¥218/¥1,305）
- Batch/Flex：gpt-5.5 在 <272K 上下文下为 $2.5 输入 / $15 输出每百万 token（约 ¥18/¥109），适合离线批量任务
- 长上下文成本：GPT-5.5 超过 272K 输入 token 的请求会按官方规则加价，正式上线前必须重新核对 Pricing 页面
- 较轻量模型：适合摘要、分类、客服、批量结构化等成本敏感任务
- 长上下文任务先压缩材料，再提交必要内容，避免无效 token 成本
- 高并发任务使用 Batch 或队列，避免触发 429
配置推荐：使用 CC Switch 接入 AI 工具
创建 API Key 后，建议用 CC Switch 统一填写 API Key、Base URL 和模型名称，再接入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具，避免手动修改配置文件出错。
使用提示
先用免费或小额度真实任务测试，再决定是否长期使用 OpenAI API
ChatGPT 订阅和 API Billing 独立计费，排查 quota 时优先看 Platform Billing
GPT-5.5 官方模型 ID 是 gpt-5.5，Pro 版本是 gpt-5.5-pro；不要把未证实的 GPT-5.5D 写入生产文案
参考 OpenAI 官方 Latest model、Models 和 Pricing 页面核对模型快照、工具支持、上下文和价格
把 API Key 放在 .env、环境变量或密钥管理器里，不要硬编码
如果要接入 Claude Code、Codex、Gemini CLI、OpenCode 等工具，建议用 CC Switch 统一管理 Key、Base URL 和模型名
注意事项
国内访问通常需要稳定代理，网络不稳定会导致 timeout、支付失败或账号风控
API Key 泄露后要立即撤销并重新生成
不要把 ChatGPT Plus/Pro 订阅当成 API 额度使用
适合谁
- • 有稳定代理环境和国际信用卡的开发者
- • 需要手把手指导完成注册、充值和获取 Key 的新手
- • 想把 OpenAI GPT 接入 Claude Code、Codex 等工具的用户
常见问题
OpenAI GPT 有免费额度吗？
请查看上方教程中的额度和计费说明，建议先小额充值测试。
注册 OpenAI GPT 需要什么？
需要能接收验证码的邮箱、稳定的代理网络和国际信用卡（或虚拟信用卡）。
API Key 泄露了怎么办？
立即到控制台删除泄露的 Key 并重新生成。建议把 Key 存在环境变量或 .env 文件中，不要提交到 Git 仓库。