ChatGPT API Key 怎么获取?注册、充值与第一次调用完整指南(2026)
围绕 ChatGPT API Key 怎么获取、ChatGPT API 价格、API 充值和 API 调用,整理一套从 OpenAI Platform 创建密钥到完成首次请求的可执行教程,并说明安全、额度与常见报错。
ChatGPT API Key 怎么获取?注册、充值与第一次调用完整指南(2026)#
如果你搜索的是“ChatGPT API Key 怎么获取”“ChatGPT API 价格”或“ChatGPT API 调用”,通常不是想了解网页端聊天,而是想把模型接入自己的脚本、网站或自动化流程。本教程从官方 OpenAI Platform 的入口开始,依次讲清楚创建密钥、配置计费、发出第一条请求和排查错误的方法。
信息说明: API 的模型、价格、地区可用性和限额会变化。本文只提供稳定的操作路径和检查方法;创建项目或充值前,请以 OpenAI Platform 和 API 定价页当前显示的内容为准。
先看结论:ChatGPT 账号、订阅和 API 是三件事#
很多第一次接触 API 的用户会把 ChatGPT 网页版和 API 混为一谈。可以先记住下面三点:
| 事项 | 说明 |
|---|---|
| ChatGPT 网页版 | 在 chatgpt.com 中与模型对话,按账号计划使用产品功能 |
| ChatGPT Plus 等订阅 | 购买的是 ChatGPT 产品计划,不等于 API 余额 |
| OpenAI API | 在 Platform 中创建 API Key,按模型和 Token 用量计费 |
因此,订阅 ChatGPT Plus 不会自动生成 API Key,也不会自动把订阅费变成 API 余额。如果你的目标是让程序调用模型,应直接进入 Platform 的 API 页面;如果只是手动聊天,则不需要写代码或创建 API Key。
ChatGPT API Key 怎么获取#
第 1 步:进入官方 Platform#
打开 platform.openai.com,使用当前可用的 OpenAI 账号登录。请核对浏览器地址栏中的域名,避免在搜索结果中误点仿冒的“API 中转”或“免费 Key”页面。
登录后,在控制台中进入 API keys 页面,也可以直接打开 API Keys 管理页。不同账号或新版控制台的菜单名称可能略有变化,但入口仍应位于官方 Platform 域名下。
第 2 步:创建项目并设置计费#
如果控制台要求先创建 Project,就按页面提示建立一个用途明确的项目,例如“博客摘要测试”。项目有助于把 Key、用量和权限分开管理。
要正式调用付费模型,还需要在官方 Billing 页面查看支付方式、预付余额或组织的计费状态。API 账户是否需要预付、是否有试用额度、可用支付方式和最低金额,取决于当前地区与账户资格;不要按照旧教程中的固定数字充值。
可以在 Usage 页面观察实际消耗,在 API 定价页核对模型的输入、输出及工具费用。看到余额不足或 quota 错误时,先检查这里,而不是反复生成新的 Key。
第 3 步:生成并保存 API Key#
在 API keys 页面选择创建新密钥。密钥通常只会在生成后完整显示一次,建议立即复制到密码管理器,再关闭页面。
以下做法不要采用:
- 不要把真实 Key 写进 Git 仓库、前端 JavaScript、公开截图或文章评论;
- 不要把 Key 粘贴到所谓“Key 检测器”或不明的代理网站;
- 不要为了排查 401 错误,把完整
Authorization请求头发到群聊; - 如果怀疑泄露,立即在控制台撤销旧 Key,再创建新 Key。
把 Key 放进环境变量#
推荐让程序从环境变量读取密钥。macOS、Linux 或 WSL 的当前终端可以这样设置:
export OPENAI_API_KEY="你的 API Key"
export OPENAI_MODEL="从模型列表复制的模型 ID"PowerShell 可以使用:
$env:OPENAI_API_KEY="你的 API Key"
$env:OPENAI_MODEL="从模型列表复制的模型 ID"OPENAI_MODEL 只是示例变量。模型 ID 会随时间、账号权限和区域变化,应该从 Models 页面复制当前可用的精确字符串,不要把博客中的模型名当成永久值。
ChatGPT API 调用:先完成一条最小请求#
用 curl 验证认证和接口地址#
新项目优先参考 Responses API 文档。下面的请求只做文本测试,模型名由环境变量提供:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer ${OPENAI_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "'"${OPENAI_MODEL}"'",
"input": "用一句话介绍 ChatGPT API。"
}'如果返回 JSON,先确认 HTTP 状态码和错误字段,再查看 output 中的结果。Responses API 的返回结构与旧版 Chat Completions 的 choices 结构不同,不要只根据旧代码判断调用是否失败。
用 Node.js 发出同样的请求#
以下示例使用 Node.js 原生 fetch,不需要把密钥写进源代码:
const apiKey = process.env.OPENAI_API_KEY;
const model = process.env.OPENAI_MODEL;
if (!apiKey || !model) {
throw new Error('请先设置 OPENAI_API_KEY 和 OPENAI_MODEL');
}
const response = await fetch('https://api.openai.com/v1/responses', {
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model,
input: '把下面这句话改写得更清楚:API 调用需要妥善保护密钥。'
})
});
const data = await response.json();
if (!response.ok) {
throw new Error(`${response.status}: ${JSON.stringify(data)}`);
}
console.log(JSON.stringify(data, null, 2));第一次验证时,建议只发送不含个人资料和生产代码的短文本。认证、模型权限、网络和计费都通过后,再逐步加入长上下文、流式输出或工具调用。
ChatGPT API 价格怎么查和估算#
价格不是 ChatGPT 月费#
API 费用通常按模型的输入 Token、输出 Token 以及部分工具的使用量计算。ChatGPT 网页版的月度订阅、API 的 Token 费用和第三方服务的套餐费属于不同账单,不能直接横向比较。
用公式估算,而不是背固定数字#
可以先用下面的方式估算一次请求:
单次费用 = 输入 Token × 输入单价 + 输出 Token × 输出单价 + 工具或图片等额外费用实际项目还要考虑系统提示词、历史对话、重试、缓存和并发。建立预算时,记录一周内的请求数、平均输入长度、平均输出长度和失败重试次数,再把这些数据带入当前定价页。模型更换后重新估算,旧文章中的价格不要直接复制。
“ChatGPT API 充值”应该在哪里完成#
只在官方 Platform 的 Billing 页面处理 API 余额或支付方式。第三方售卖的“低价 API Key”“共享余额”和“无限调用”无法替代官方账单,也会带来密钥泄露、数据留存和账号封禁风险。购买前应确认组织的合规要求,并为真实业务设置月度预算和用量提醒。
常见报错排查表#
| 现象 | 优先检查 | 处理建议 |
|---|---|---|
401 或 invalid_api_key | 环境变量是否为空、Key 是否复制完整、是否已撤销 | 在当前终端重新读取变量,必要时撤销并重新生成 |
403 | 组织、项目或模型权限 | 查看当前 Project 和模型可用性,不要只换一把 Key |
404 | URL 路径或模型 ID | 核对是否使用 /v1/responses,并从官方模型页复制 ID |
429 | 速率限制、余额或项目额度 | 降低并发、采用有上限的退避重试并检查 Usage/Billing |
| 返回内容为空 | 代码仍按旧接口读取 choices | 先打印完整 JSON,再按 Responses API 结构提取结果 |
| 网页能用但程序不能用 | 两者使用的账号、区域或服务不同 | 分别核对 ChatGPT 账号和 API Project 的状态 |
不要在遇到 429 时无限重试,也不要在错误日志中打印完整请求头。对超时和临时错误设置有限次数的指数退避,并保留状态码、请求时间和脱敏后的错误信息即可。
上线前的 API Key 安全清单#
- [ ] Key 只存在于服务器环境变量或密钥管理服务中。
- [ ] 浏览器端不直接携带 OpenAI Key;需要前端调用时先经过自己的后端。
- [ ] 为测试、预发布和生产环境使用不同的项目或密钥。
- [ ] 对单用户请求数、输入长度和月度预算设置上限。
- [ ] 日志移除
Authorization、个人资料和完整提示词中的敏感内容。 - [ ] 定期检查 Usage,发现异常消耗后先撤销密钥,再调查来源。
FAQ:关于 ChatGPT API 的 6 个问题#
ChatGPT Plus 用户还要单独申请 API Key 吗?#
要。ChatGPT 订阅和 OpenAI API 是两个产品面,API Key 需要在 Platform 的 API keys 页面创建,费用也单独计算。
API Key 怎么获取最安全?#
直接从 platform.openai.com/api-keys 进入官方控制台创建,并立即保存到密码管理器或服务器密钥管理服务中。不要从论坛、网盘或群聊复制他人的 Key。
没有信用卡能不能调用 API?#
是否支持预付、试用或其他支付方式取决于当前地区、账户和组织设置。登录官方 Billing 页面查看自己的资格,不要用来源不明的共享 Key 代替。
ChatGPT API 可以免费使用吗?#
部分账号可能存在试用额度或活动,但不是所有账号都有,且额度、过期时间和模型范围会变化。以 Usage 和 Billing 中的实际状态为准。
应该使用 Chat Completions 还是 Responses API?#
新项目优先阅读 Responses API 文档;维护旧项目时,再按当前官方迁移说明评估。无论选哪种接口,都要以当前模型文档支持的能力为准。
API 调用可以直接放在网页前端吗?#
不建议。浏览器代码会暴露 Key,其他人可以复制并消耗你的额度。通常由自己的后端保存 Key,再对前端提供受限接口。
最后检查#
如果你只是想在网页中聊天,直接使用 ChatGPT 使用教程即可,不必创建 API Key。如果你要做图像创作,可以继续看 ChatGPT 图片生成提示词与额度指南。如果你确实要接入程序,按“官方 Platform 登录 -> 创建 Project -> 查看 Billing -> 生成 Key -> 环境变量 -> 最小请求”的顺序完成验证,并在每次模型或计费规则变化后重新查看官方页面。
相关官方入口: