用量与计费

OpenAI API Key 怎么获取:平台账号、项目密钥与充值(2026)

ROIBest AI

「OpenAI API Key 怎么获取」真正在问什么

搜 openai api key 怎么获取 的人,通常是想拿到一把能放进客户端里用的密钥,而不是 ChatGPT 的登录态。这是两套产品,两份账单。

OpenAI API Key 是在 API 平台 签发的密钥,用来鉴权对 API 的 HTTP 请求。ChatGPT Plus 或 Pro 订阅并不包含 API 用量,也不会发给你一把 API Key。OpenAI 的 账单说明 写得很清楚:ChatGPT 和 API 平台是两套计费系统,API 额度记在 API 组织上,不属于 ChatGPT 套餐。

本文只回答第一件事:在 API 平台开账号、签发项目密钥、充值预付额度、安全保存,并完成第一次调用。密钥轮换见 API Key 轮换最佳实践,配额和过期见 密钥配额与过期,那些是密钥已经能用之后的事。

开始之前:账号、组织,以及你所在地区是否支持

你需要一个 OpenAI 账号,并加入一个 API 组织。新账号通常会自动带一个组织和一个 Default 项目。密钥的作用范围是项目。如果是公司邀请你进组织,先在平台顶部的选择器里切到正确的组织和项目,再创建密钥,否则费用会记到错误的地方。

API 并不是在所有地区都能用。OpenAI 公布了一份 支持的国家和地区名单。名单以外的地点不被支持。官方还写明:从不受支持的地点访问或对外提供该服务,可能导致账号被封禁或停用。如果第一次请求返回 403,并提示 Country, region, or territory not supported,这是地区限制,不是密钥抄错。本文不讨论任何绕过方法。

第一步:创建项目 API Key

OpenAI 帮助文档 Where do I find my OpenAI API Key? 和 开发者快速上手 指向同一操作:在 API 控制台里创建密钥。

  1. 登录 platform.openai.com,不是 chatgpt.com。
  2. 确认顶部选择器里的组织和项目。第一次个人使用可以用 Default 项目;如果已经明确要隔离某个应用或环境,就新建一个项目。
  3. 打开该项目的 API keys 页面,选择 Create new secret key。
  4. 给密钥起一个以后能认出来的名字,例如 local-dev 或 staging-web。立刻复制完整密钥,放到只有你能读到的地方。

完整密钥只在创建时显示一次。如果关掉对话框时没有保存,之后无法再查看。只能再创建一把,并改应用里的配置。在同一页删除密钥后,所有还在用它的客户端都会失效。

OpenAI 的 API keys 与服务账号 指南区分了三种凭证,按用途选:

你在做什么

该创建的凭证

自己本机开发或试用

用户名下的项目 API Key

已部署的应用、定时任务或 CI

项目服务账号,再给这个服务账号签发密钥

代为创建项目或管理他人密钥的自动化

Admin API Key,只用于 Admin API,不要拿去调模型

用户名下的密钥以你本人的权限行事。不要把某一个开发者的密钥分给整个团队,也不要把某个人笔记本上的密钥当作生产服务的长期身份。

第二步:充值预付额度(光有密钥还不够)

新的 API 账号使用 预付费账单。创建密钥并不会给组织充值。在登记支付方式并买入额度之前,即使密钥是对的,调用也通常会失败。之后常见的错误是 429,错误码 credit_balance_exhausted。

如果你有该组织的账单管理权限:

  1. 打开该组织的 API billing overview。
  2. 添加支付信息。
  3. 选择首次充值金额。最低 5 美元,设置流程里的默认值是 10 美元。
  4. 确认前检查 Use auto-reload。设置时默认是打开的。如果不希望自动扣款,就关掉;或者设置触发阈值、补到的金额,以及可选的每月自动充值上限。
  5. 确认购买,然后等几分钟看余额是否更新。

买入的额度一年后过期。官方还写明:2026 年 11 月 13 日之后在日本购买的额度,有效期是 180 天。除法律、合同或经批准的例外情况外,额度通常不可退。账户的 trust tier(由用量和付款记录决定)会限制账户能持有的最高余额。

即便有 ChatGPT 赠送的 API 额度,那也是记在 API 组织上的额度,不能替代 ChatGPT 订阅;Plus 账单也不能替代 API 预付额度。

第三步:保存密钥,并完成第一次调用

官方快速上手要求把密钥放进名为 OPENAI_API_KEY 的环境变量。官方 SDK 会自动读取它。

macOS 或 Linux:

export OPENAI_API_KEY="your_api_key_here"

Windows PowerShell:

setx OPENAI_API_KEY "your_api_key_here"

不要把密钥提交进 git、粘贴到共享聊天,或打进前端打包文件。一旦泄露,到 API keys 页面作废它并签发新的;重叠窗口的做法见 轮换指南。

下面是官方 快速上手 风格的最小 Python 检查。模型名请以官方模型列表为准,名称会变。

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-6.2-astra",
    input="Reply with the single word pong.",
)
print(response.output_text)

如果能打印出简短回复,说明密钥、账单和网络路径是通的。要让官方 OpenAI 密钥工作,不需要再配一个 第三方兼容端点。兼容 API 是另一种产品:你改的是 base URL,用的往往也是另一家供应商的密钥。

第一次调用失败时

先看状态码,再决定要不要重开一把密钥。OpenAI 的 错误码说明 对应这些常见情况:

现象

通常意味着

先做这一步

401,incorrect API key

密钥抄错、被截断、来自错误的项目,或已经被吊销

核对密钥前缀和所属项目,或新建密钥并替换环境变量

401,不是组织成员

账号还没有加入 API 组织

请组织所有者邀请你,再在该组织里创建密钥

403,country or territory not supported

请求来自不在支持名单上的地点

查看 官方名单;这不是密钥格式问题

429,credit_balance_exhausted

组织的预付额度用完了

在 API 账单页充值后再试

429,spend 或 usage limit

触发了组织或项目的限额

有权限就提高或取消限额,或等周期重置

如果你其实想走 Claude 的密钥流程,那是另一套控制台,见 Claude API 怎么用。若要看厂商、云平台、托管和路由的整体分类,见 LLM API 供应商。

常见问题

ChatGPT Plus 算不算 OpenAI API Key?

不算。Plus 是 ChatGPT 产品订阅。API 用量在 API 平台单独计费。你仍然要创建密钥,并给 API 组织充值。

密钥是在 ChatGPT 里创建,还是在 API 平台创建?

在 API 平台 platform.openai.com 里,到目标项目的 API keys 页面创建。ChatGPT 设置不会签发 API Key。

已经创建过的密钥还能再看一遍吗?

不能。完整密钥只在创建时显示一次。如果弄丢了,就新建一把,并更新所有还在用旧密钥的客户端。

必须先充值,密钥才能用吗?

对新的 API 账号来说,实际上需要。新组织使用预付费。没有额度的密钥走不远;到 API billing overview 充值,最低 5 美元。

生产环境可以用个人密钥吗?

不可以。已部署的应用或 CI 应使用项目服务账号,以及这个账号名下的密钥,让工作负载有独立身份,吊销时也不会打断某个人的本地开发。

我已经有另一家供应商的 OpenAI 兼容密钥,是一回事吗?

不是。OpenAI 兼容 API 只是请求格式相近。它不是 OpenAI 平台密钥,也不能用来鉴权 api.openai.com,除非那家供应商就是 OpenAI。

先拿到密钥,再充值并保存好

OpenAI API Key 怎么获取,官方流程就三步:登录 API 平台,创建一把项目密钥并只保存这一次,然后在 API 账单页充入预付额度。把密钥放进环境变量,先打通一次调用,再接到应用里。调用失败时,优先相信状态码,尤其是 401、403 和 429,不要急着重开密钥。