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 的当前终端可以这样设置:

bash
export OPENAI_API_KEY="你的 API Key"
export OPENAI_MODEL="从模型列表复制的模型 ID"

PowerShell 可以使用:

powershell
$env:OPENAI_API_KEY="你的 API Key"
$env:OPENAI_MODEL="从模型列表复制的模型 ID"

OPENAI_MODEL 只是示例变量。模型 ID 会随时间、账号权限和区域变化,应该从 Models 页面复制当前可用的精确字符串,不要把博客中的模型名当成永久值。

ChatGPT API 调用:先完成一条最小请求#

用 curl 验证认证和接口地址#

新项目优先参考 Responses API 文档。下面的请求只做文本测试,模型名由环境变量提供:

bash
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,不需要把密钥写进源代码:

js
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 费用和第三方服务的套餐费属于不同账单,不能直接横向比较。

用公式估算,而不是背固定数字#

可以先用下面的方式估算一次请求:

text
单次费用 = 输入 Token × 输入单价 + 输出 Token × 输出单价 + 工具或图片等额外费用

实际项目还要考虑系统提示词、历史对话、重试、缓存和并发。建立预算时,记录一周内的请求数、平均输入长度、平均输出长度和失败重试次数,再把这些数据带入当前定价页。模型更换后重新估算,旧文章中的价格不要直接复制。

“ChatGPT API 充值”应该在哪里完成#

只在官方 Platform 的 Billing 页面处理 API 余额或支付方式。第三方售卖的“低价 API Key”“共享余额”和“无限调用”无法替代官方账单,也会带来密钥泄露、数据留存和账号封禁风险。购买前应确认组织的合规要求,并为真实业务设置月度预算和用量提醒。

常见报错排查表#

现象优先检查处理建议
401 或 invalid_api_key环境变量是否为空、Key 是否复制完整、是否已撤销在当前终端重新读取变量,必要时撤销并重新生成
403组织、项目或模型权限查看当前 Project 和模型可用性,不要只换一把 Key
404URL 路径或模型 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 -> 环境变量 -> 最小请求”的顺序完成验证,并在每次模型或计费规则变化后重新查看官方页面。

相关官方入口: