Skip to content

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/ProOpenAI API
使用方式chatgpt.com 网页、桌面或移动端程序、服务器、SDK 或第三方应用
主要计费订阅套餐按模型和实际用量计费,另有可能适用的工具费用
Key不需要 API Key需要项目级 Secret Key
额度由账号套餐和产品规则决定由项目余额、预算、速率限制和模型权限决定
适合场景对话、写作、文件分析网站、自动化、客服、批处理和产品集成

不要把 ChatGPT 网页端的登录 Cookie、共享账号或 Plus 会员密码当作 API 凭证。官方 API Key 只在开发者平台创建和撤销。

二、官方 API Key 获取步骤 ​

  1. 打开 platform.openai.com,登录自己的 OpenAI 账号。
  2. 创建或选择一个项目,按页面提示完成账单、组织和安全设置。
  3. 进入项目的 API Keys 页面,创建新的 Secret Key。
  4. 密钥完整内容通常只在创建后显示一次,立即保存到密码管理器或服务器 Secret 中。
  5. 回到 Usage 和 Billing 页面确认项目、预算、余额与限额。

官方文档入口:

页面名称、验证步骤和可用功能会调整。遇到“没有创建权限”或“模型不可用”,先看项目所属组织和控制台提示,不要从旧教程复制账号设置。

OpenAI API Key 控制台登录示意

图: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.py

OPENAI_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,以及图片、工具或其他服务分别计算。模型目录、价格页和控制台账单是唯一可靠的核验位置:

  1. 在 官方价格页 查看当前单价和计费单位;
  2. 在项目 Usage 页面查看真实 token 和请求量;
  3. 在 Billing 页面设置预算提醒、项目限额和付款方式;
  4. 用小批量真实请求做成本测试,再决定默认模型和上下文长度。

不要把第三方网关的包月价、倍率或“无限额度”当成 OpenAI 官方 API 价格。需要使用第三方兼容服务时,单独检查 Base URL、模型路由、日志保留和隐私条款。

八、常见报错排查 ​

报错常见原因建议处理
401 UnauthorizedKey 不完整、已撤销,或发送到了错误的域名重新复制项目 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 产品名称、模型、价格、权限和接口可能更新,正式接入前请以官方文档和登录后的控制台为准。

本站为独立的 Grok 中文教程与导航站,非 xAI 官方网站。