深色模式
ChatGPT API Key 怎么获取?Plus 和 API 的区别、Responses API 调用与报错排查(2026)
更新时间:2026年10月6日 | 本文会随官方控制台和文档变化复核
先说结论:ChatGPT Plus/Pro 订阅和 OpenAI API 是两套独立的产品与计费体系。订阅 ChatGPT 不会自动得到可用于程序的 API Key;开发者需要在 OpenAI Platform 创建项目、配置账单并单独生成 Key。API 的模型、价格、地区、额度和权限,以你登录后看到的官方控制台为准。
API 站点推荐:ZeoAPI
如果你需要一个第三方兼容网关来接入多种模型,可以查看 ZeoAPI 注册入口。ZeoAPI 是独立第三方服务,不是 OpenAI 官方 API,也不会把第三方 Key 变成 OpenAI 官方 Key;Base URL、模型路由、价格、限额、日志保留和数据政策,都要以登录后的控制台和服务条款为准。注册链接包含推荐参数,是否使用完全自愿;正式业务请先用不含敏感信息的小项目做验证。
如果只是想在网页里体验 GPT-6、Grok、Claude、Gemini 等多模型,可以查看 GPTCat 或 SnakeGPT;它们同样是独立第三方网页产品,不等于 OpenAI API。需要把模型接入自己的程序,仍应按下文的官方 Platform 流程操作。
一、ChatGPT 订阅和 API 到底有什么区别?
| 项目 | ChatGPT Plus/Pro | OpenAI API |
|---|---|---|
| 使用方式 | chatgpt.com 网页、桌面或移动端 | 程序、服务器、SDK 或第三方应用 |
| 主要计费 | 订阅套餐 | 按模型和实际用量计费,另有可能适用的工具费用 |
| Key | 不需要 API Key | 需要项目级 Secret Key |
| 额度 | 由账号套餐和产品规则决定 | 由项目余额、预算、速率限制和模型权限决定 |
| 适合场景 | 对话、写作、文件分析 | 网站、自动化、客服、批处理和产品集成 |
不要把 ChatGPT 网页端的登录 Cookie、共享账号或 Plus 会员密码当作 API 凭证。官方 API Key 只在开发者平台创建和撤销。
二、官方 API Key 获取步骤
- 打开 platform.openai.com,登录自己的 OpenAI 账号。
- 创建或选择一个项目,按页面提示完成账单、组织和安全设置。
- 进入项目的 API Keys 页面,创建新的 Secret Key。
- 密钥完整内容通常只在创建后显示一次,立即保存到密码管理器或服务器 Secret 中。
- 回到 Usage 和 Billing 页面确认项目、预算、余额与限额。
官方文档入口:
页面名称、验证步骤和可用功能会调整。遇到“没有创建权限”或“模型不可用”,先看项目所属组织和控制台提示,不要从旧教程复制账号设置。

图:API Key 配置界面示意。请不要在截图、文章评论或公开仓库中展示真实密钥。
三、把 Key 放进环境变量
Windows PowerShell
powershell
$env:OPENAI_API_KEY = "sk-你的密钥"
$env:OPENAI_MODEL = "控制台中显示的模型 ID"只想让新终端也能读取,可以使用 setx;执行后需要重新打开终端:
powershell
setx OPENAI_API_KEY "sk-你的密钥"macOS 或 Linux
bash
export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_MODEL="控制台中显示的模型 ID"生产项目应使用云平台的 Secret、CI/CD 密钥库或操作系统密钥服务。.env 只适合本地开发,并应加入 .gitignore。
四、用 Python 调用 Responses API
先安装官方 Python SDK:
bash
python -m pip install --upgrade openai新建 responses_demo.py:
python
import os
from openai import OpenAI
api_key = os.environ["OPENAI_API_KEY"]
model = os.environ["OPENAI_MODEL"]
client = OpenAI(api_key=api_key)
response = client.responses.create(
model=model,
input="用三句话说明 API Key 为什么不能放在浏览器前端。",
)
print(response.output_text)运行:
bash
python responses_demo.pyOPENAI_MODEL 必须替换成你在官方 Models 页面和项目中实际可用的模型 ID。文章标题或第三方平台显示的“GPT-6 Astra”等名称,不等于所有账号都可直接调用的 API ID;如果返回 model_not_found,先核对控制台,而不是盲目改参数。
五、用 JavaScript 调用 Responses API
安装官方 Node.js SDK:
bash
npm install openai新建 responses-demo.mjs:
javascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
const response = await client.responses.create({
model: process.env.OPENAI_MODEL,
input: "给我一个可执行的 API 成本记录方案。",
});
console.log(response.output_text);运行:
bash
node responses-demo.mjs这段代码只能放在服务器、后端函数或受保护的任务环境里。浏览器脚本、公开仓库、移动 App 包和前端构建产物都可能暴露 Key。需要在网页中调用时,应让前端请求自己的后端,由后端完成 OpenAI 请求。
六、为什么新项目要了解 Responses API?
Responses API 面向多轮输入、文本和图像等多模态内容、工具调用、流式输出以及 Agent 工作流。具体能力由模型和项目权限决定,不能因为接口支持某个字段就假定每个模型都支持它。开始迁移或设计新项目时,先阅读 Responses API 官方文档,再按目标模型的文档验证参数。
旧项目仍在使用 Chat Completions 时,可以先用固定测试集比较输出,再逐步迁移。迁移时记录模型 ID、输入格式、工具定义、错误处理和成本,避免只改 endpoint 而忽略业务逻辑。
七、API 价格和额度怎么核验?
API 没有一个对所有账号永久有效的“ChatGPT 价格”。费用可能按输入 token、缓存输入、输出 token,以及图片、工具或其他服务分别计算。模型目录、价格页和控制台账单是唯一可靠的核验位置:
- 在 官方价格页 查看当前单价和计费单位;
- 在项目 Usage 页面查看真实 token 和请求量;
- 在 Billing 页面设置预算提醒、项目限额和付款方式;
- 用小批量真实请求做成本测试,再决定默认模型和上下文长度。
不要把第三方网关的包月价、倍率或“无限额度”当成 OpenAI 官方 API 价格。需要使用第三方兼容服务时,单独检查 Base URL、模型路由、日志保留和隐私条款。
八、常见报错排查
| 报错 | 常见原因 | 建议处理 |
|---|---|---|
| 401 Unauthorized | Key 不完整、已撤销,或发送到了错误的域名 | 重新复制项目 Key,确认环境变量和 endpoint |
| 403 Forbidden | 项目、地区、组织或权限限制 | 查看控制台提示,确认项目和账号状态 |
| 400 Bad Request | 参数、输入格式或工具定义错误 | 按错误字段逐项缩小请求 |
| 404 / model not found | 模型 ID 不存在或项目未开放 | 到 Models 页面复制当前 ID |
| 429 Too Many Requests | 速率、余额或并发限制 | 降低并发,采用有上限的退避并检查 Usage |
| 5xx / timeout | 服务、网络或任务过重 | 设置超时、流式输出并有限重试 |
重试只适用于暂时性 429 或 5xx。对于 401、403、400 和模型不存在,反复重试不会解决权限或参数问题。记录 request ID、时间、模型和错误码,联系官方支持时更容易定位。
九、API Key 安全清单
- 每个项目使用独立 Key,按最小权限和用途分开管理;
- 不把 Key 写入前端、日志、截图、Issue 或 Git 历史;
- 发现泄露后立即撤销旧 Key,创建新 Key,并检查 Usage 和账单;
- 对自己的后端接口加登录、频率限制、输入长度限制和预算保护;
- 对用户文件、个人资料和企业代码先做脱敏,确认数据处理政策;
- 给自动化任务设置最大输出、超时和重试次数。
十、FAQ
ChatGPT Plus 包含 API 额度吗?
不包含。ChatGPT 订阅与 API 项目分别管理、分别计费。是否有活动额度或试用,以控制台当前提示为准。
API Key 能直接放在网页 JavaScript 里吗?
不能。任何访问者都可能查看前端代码或网络请求。正确方式是前端调用自己的后端,由后端读取环境变量中的 Key。
GPT-6 Astra 的 API ID 和价格是多少?
不要仅凭文章标题或第三方列表判断。打开官方 Models 和 Pricing 页面,登录目标项目后确认实际 ID、上下文、权限和价格;这些信息可能按时间、地区和账号变化。
Responses API 能不能直接替换所有旧代码?
不能保证。输入结构、输出读取、工具调用和错误处理可能不同。先阅读迁移文档,并用固定样例验证结果和成本。
我可以用第三方 API Key 调用官方 endpoint 吗?
通常不行。第三方 Key、Base URL 和模型路由属于第三方平台,应按其文档配置;不要把第三方服务宣传为 OpenAI 官方 API。
相关阅读
本文为独立整理的教程。OpenAI 产品名称、模型、价格、权限和接口可能更新,正式接入前请以官方文档和登录后的控制台为准。