OpenAI API Key 怎么获取:平台账号、项目密钥与充值(2026)
「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 控制台里创建密钥。
- 登录 platform.openai.com,不是 chatgpt.com。
- 确认顶部选择器里的组织和项目。第一次个人使用可以用 Default 项目;如果已经明确要隔离某个应用或环境,就新建一个项目。
- 打开该项目的 API keys 页面,选择 Create new secret key。
- 给密钥起一个以后能认出来的名字,例如
local-dev或staging-web。立刻复制完整密钥,放到只有你能读到的地方。
完整密钥只在创建时显示一次。如果关掉对话框时没有保存,之后无法再查看。只能再创建一把,并改应用里的配置。在同一页删除密钥后,所有还在用它的客户端都会失效。
OpenAI 的 API keys 与服务账号 指南区分了三种凭证,按用途选:
|
你在做什么 |
该创建的凭证 |
|---|---|
|
自己本机开发或试用 |
用户名下的项目 API Key |
|
已部署的应用、定时任务或 CI |
项目服务账号,再给这个服务账号签发密钥 |
|
代为创建项目或管理他人密钥的自动化 |
Admin API Key,只用于 Admin API,不要拿去调模型 |
用户名下的密钥以你本人的权限行事。不要把某一个开发者的密钥分给整个团队,也不要把某个人笔记本上的密钥当作生产服务的长期身份。
第二步:充值预付额度(光有密钥还不够)
新的 API 账号使用 预付费账单。创建密钥并不会给组织充值。在登记支付方式并买入额度之前,即使密钥是对的,调用也通常会失败。之后常见的错误是 429,错误码 credit_balance_exhausted。
如果你有该组织的账单管理权限:
- 打开该组织的 API billing overview。
- 添加支付信息。
- 选择首次充值金额。最低 5 美元,设置流程里的默认值是 10 美元。
- 确认前检查 Use auto-reload。设置时默认是打开的。如果不希望自动扣款,就关掉;或者设置触发阈值、补到的金额,以及可选的每月自动充值上限。
- 确认购买,然后等几分钟看余额是否更新。
买入的额度一年后过期。官方还写明: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, |
组织的预付额度用完了 |
在 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,不要急着重开密钥。