OpenAI API Key怎么获取呢?OpenAI API Key 的官方入口是开发者平台 platform.openai.com,签钥页面为 platform.openai.com/api-keys:登录后确认组织与项目,点「Create new secret key」即可生成,完整密钥只在创建时显示一次。当前新 API 账号走预付费模式(首次购买最低 5 美元),模型已更新到 GPT-6 Astra 一代。本文整理了创建流程、密钥类型与权限、价格与计费规则、报错速查与国内可及性说明,一起往下来来看看吧。
官方入口有哪些,API Key 在哪个页面创建
这套体系里最容易被混淆的一点是:「和 AI 聊天的地方」与「拿 Key 的地方」不是同一个产品,也不是同一个钱包。聊天入口是 chatgpt.com,而 API Key 只存在于开发者平台 platform.openai.com。官方帮助中心对「在哪里找到 API Key」的回答只有一句原文:You can create and manage your API keys on the API key page.——该页面即 platform.openai.com/api-keys。
- 开发者平台:platform.openai.com,注册、创建 Key、看用量与账单都在这里,面向程序化调用,按量计费。
- API Key 管理页:platform.openai.com/api-keys,创建、查看与删除密钥的主页面。
- 组织级 Key 设置:platform.openai.com/settings/organization/api-keys,官方错误码文档中给出的排查入口。
- 账单页:platform.openai.com/account/billing,充值、绑卡与自动充值设置;用量页为 platform.openai.com/usage。
- 限额页:platform.openai.com/settings/organization/limits,查看组织与项目级的速率与用量上限。
- Admin Key 页:platform.openai.com/settings/organization/admin-keys,仅组织所有者/管理员需要。
- 支持地区名单:developers.openai.com/api/docs/supported-countries,判断所在地是否在服务范围内。
注意区分:官方 ChatGPT Plus 帮助页在权益清单里专门写了一条「不包括:API 使用量另计并单独收费」,也就是说订阅会员与 API 额度是两套完全分开的计费体系,买会员不会自动获得可调用的配额。
还有一个前置条件常被忽略:Key 必须挂在某个组织与某个项目之下。官方错误码表把「You must be a member of an organization to use the API」列为 401 的一种,其原因是 Your account is not part of an organization.项目则用于隔离环境,官方帮助中心说明组织所有者才能在左下角项目名称处选择 Create project。
OpenAI API Key怎么获取:5 步创建流程
官方快速开始页的表述是把创建与使用连在一起的:先在控制台创建一把 API Key,再把它作为环境变量导出,因为Each OpenAI SDK automatically reads your API key from the system environment.落到操作上共 5 步:
- 登录并确认组织与项目:访问 platform.openai.com 登录,组织名称与组织 ID 可在组织设置页查看;多组织的账号请求时可用请求头指定归属。
- 打开 API keys 页面:进入 platform.openai.com/api-keys,点 + Create new secret key(也可在某个项目的设置页里为该项目建设密钥)。
- 填写名称,选项目与权限:官方提供三级权限 All、Restricted、Read Only,可在此步选择,也可事后编辑已有密钥的权限;建议同时设置过期时间。
- 立即复制并妥善保存:官方原文是 For security, a full secret key is only shown when you create it.页面关闭后无法再次查看,官方给出的唯一补救办法是 create a new key and update your application to use the new key.
- 写入环境变量,并确认余额:官方推荐变量名统一为 OPENAI_API_KEY;余额为零时调用不会成功,会返回 429 且错误码为 credit_balance_exhausted,需先到账单页充值。
验证是否生效,官方快速开始给出的最小请求走的是 Responses API(端点 https://api.openai.com/v1/responses),认证方式是 HTTP Bearer:
如果账号属于多个组织,或用的是旧版用户密钥,官方文档建议显式传请求头,否则会按默认组织的额度计费:-H "OpenAI-Organization: $ORGANIZATION_ID" 与 -H "OpenAI-Project: $PROJECT_ID"。删除密钥也很直接:官方帮助中心写法是在 API keys 页选中密钥旁的垃圾桶图标,并且提醒 deleted keys cannot be used, so applications that rely on them may stop working.
四类密钥与三级权限,哪把该用在哪种场景
官方文档按用途而不是按前缀来区分密钥,这一点在后面的提示框里还会再强调一次。开发者平台当前对外承认的凭证有四类:
| | |
|---|
| | |
| 用于组织管理端点:邀请成员、审计日志、项目管理、密钥管理、支出限额与告警等 | 官方原文「Admin API keys cannot be used for non-administration endpoints」,不能调用模型推理;SDK 使用独立变量 OPENAI_ADMIN_KEY |
| 挂在项目下的机器身份,适合生产服务与 CI 等长期后台任务 | 官方原文「Service accounts are only scoped to projects」,不能跨项目使用;权限默认是该项目的读写全部资源 |
| | 官方文档仍在认证章节提及 legacy user API key,属遗留形态,新账号拿到的是项目下的标准密钥 |
除这四类之外,官方认证章节还并列提到了工作负载身份联合(workload identity federation),用于签发短时访问令牌,同样以 Bearer 方式认证。
权限与有效期则由组织与项目两层策略共同决定:
| |
|---|
| |
| 按端点或资源范围收窄,适合只读数据、只跑某类任务的服务 |
| |
关于有效期,官方最佳实践的原话是We strongly recommend creating keys with an expiration date and establishing a regular key rotation process.管理员还可以在组织或项目层面强制一个最长生命周期,官方特别注明「Project limits cannot exceed the organization limit」——项目级上限不得超过组织级。
关于密钥前缀:不要凭 sk- 后面的字母猜权限。网上流传的 sk-proj-、sk-svcacct-、sk-admin- 三分法,来自第三方技术分析文章,官方文档并未公布前缀规范,官方只按「标准 API key / Admin API key / 旧版用户密钥」的用途区分。判断一把 Key 能做什么,唯一可靠的依据是控制台里它的类型、所属项目与权限级别;前缀只能作为识别线索,不能作为权限判断依据。
模型价格与用量等级:调用大概要花多少钱
以下单价来自官方 API 定价页(美元 / 每百万 token,短上下文档位):
读这张表的三个要点:① 旗舰与非旗舰差距极大,gpt-6-astra 的输入价是 gpt-5.4-mini 的十倍以上,gpt-5-nano 档更是低到 $0.05 / 百万输入 token,选型比压价更有效;② 缓存命中能让输入价降到十分之一(astra $10 → $1),长提示词反复调用务必用缓存;③ 长上下文档位另有一套价,astra 在长上下文档位为输入 $20、输出 $75,约合短档的两倍。此外同一个模型在不同服务档位价格不同:Batch 与 Flex 档约为标准价的一半,Fast 档约为标准价的两倍——原文注明 Priority processing 于 2026 年 7 月 30 日更名为 Fast mode。
价格还会随时间与渠道变动,官方页面已明确标注的几处包括:GPT-5.6 Sol 的促销价「available at least through November 21, 2026」;区域处理(数据驻留)端点对 2026 年 3 月 5 日及之后发布的合规模型加价 10%;经 Amazon Bedrock 调用时计费走 AWS,「Bedrock pricing in commercial regions matches OpenAI direct pricing for equivalent services」。
另一个影响成本上限的因素是用量等级。官方按累计付费金额自动升级,等级越高,多数模型的速率上限越宽:
需要提醒的是:速率限制定义在组织级与项目级,不是用户级。官方原文为 Rate limits are defined at the organization level and at the project level, not user level.由此推出一个实务结论——在同一个项目里多建几把 Key 只是多了几个吊销入口,并不能让速率额度翻倍;要让不同服务互不挤占,应当拆成不同项目。
计费规则:预付费、自动充值与额度有效期
OpenAI API 是预付费模式,官方定义是 Prepaid billing lets you purchase credits before using the API. Your credit balance decreases as you use the API.并明确 New API accounts use prepaid billing.——新 API 账号默认就是先充值后使用,没有月结账单的容错空间。
- 首次购买:最低 5 美元,默认金额 10 美元(原文 The minimum purchase is $5, and the default amount is $10.)。
- 额度有效期:购买额度 1 年后过期,原文 Purchased credits expire after 1 year.且官方不延长有效期。
- 自动充值:初始化流程中 Use auto-reload 默认开启,可设置余额阈值、回充金额与可选的月度回充上限;单次自动回充最低同样是 5 美元。
- 免费额度:官方计费文档只以条件句提到 If your account has free credits, those are used before purchased credits.即赠送额度优先于充值额度消耗,但并未承诺新账号固定赠送多少。具体有没有、有多少,应以你自己账号账单页显示的余额为准。
还有两条官方特别澄清的边界,能解释不少「明明充了钱还是报错」的情况:
- 余额不等于额度全开:原文 A positive credit balance does not mean a request is below every API limit.请求与 token 速率限制、组织被批准的月用量上限、以及已启用的支出限额,都是独立于预付余额的另一套机制。
- 回充上限不是用量上限:原文 A recharge limit is not an API usage limit. It controls automatic credit purchases, not the amount of existing credits you can use.真正能卡住调用的是组织级与项目级的支出限额设置。
国内用户会遇到什么:支持地区名单与 403 报错
这是「怎么获取」这个问题里最需要提前说明的一节:注册与建 Key 这两步本身不校验地区,限制出现在服务提供范围这一层。官方支持地区名单页在名单前给出两段原话:
- Accessing or offering access to our services outside of the countries and territories listed below may result in your account being blocked or suspended.
- If a location is not included in the list below, our API is not supported there.
该名单不包含中国大陆、中国香港与中国澳门。与之对应,官方错误码表中有一个专门的状态码:403 Country, region, or territory not supported,原因写作 You are accessing the API from an unsupported country, region, or territory.换句话说,即便成功拿到 Key,从名单外发起调用也会被拒绝,而且官方原文已明确提示账号存在被封停的风险。
对确有合规需求的企业用户,官方定价页给出了另一条公开渠道的说明:经 Amazon Bedrock 调用时计费走 AWS,商业区域的 Bedrock 定价与 OpenAI 直连的等价服务一致。具体某个区域是否可用、以哪一方的主体签合同,需以各云平台自己的文档与资质要求为准。本文不提供、也不建议任何绕过地区限制的做法。
报错速查:Key 相关错误码对照表
以下条目全部取自官方 API 错误码指南,按「先看状态码、再看 error.code」的顺序排查最省时间:
| | |
|---|
401 Incorrect API key provided | | 核对是否有多余空格或拼写错误、是否属于另一个组织/项目、是否已被删除;旧密钥可能被本地缓存,可清缓存或直接新建一把 |
401 Invalid Authentication | | 可能是密钥已被吊销、与请求组织不匹配,或这把密钥没有所调用端点的权限;核对密钥与组织 ID |
401 You must be a member of an organization to use the API | | |
| | 从正确 IP 发起请求,或调整 IP 允许列表设置 |
403 Country, region, or territory not supported | | 该地区官方不提供 API 服务,需先核对支持地区名单 |
429 credit_balance_exhausted | | |
429 Rate limit reached for requests | | 放慢请求节奏,若响应带 Retry-After 头就按其等待,否则用带抖动的指数退避 |
| | 在组织或项目的限额设置里提高或移除上限,否则需等月度周期重置 |
另外两类不指向密钥本身但同样常见:500 The server had an error while processing your request(服务端问题,稍候重试并查看状态页);503 Model temporarily overloaded(该模型当前容量不足,按 Retry-After 重试)。还有一个容易被误判为「Key 出问题」的情形:官方提示当流量达到每秒 100 万输入 token 后,增速不应超过每 15 分钟 50%,违背这条经验值会拿到 429 slow_down——它发生在速率与 token 上限之内,属于加档过陡而非超限。
使用 API Key 的 3 条限制与安全底线
- 只在创建时完整显示一次:官方原文 a full secret key is only shown when you create it,页面关闭后无法再查看;丢失只能删除旧 Key 并新建,再更新应用配置。
- 绝不能放进浏览器或移动端代码:官方原文 Don't share it with others or expose it in any client-side code such as browsers or apps.请求应统一经由自己的后端服务转发,密钥只在服务端读取。
- 不要提交进代码仓库,泄露后立刻轮换:官方把「提交到源码」列为凭证泄露的常见途径,并建议若怀疑泄露,立即在 API keys 页轮换;生产环境应改用密钥管理服务而不是明文配置文件。
OpenAI API Key 常见问题
Q:获取 OpenAI API Key 本身要花钱吗?
A:创建密钥这一动作不需要付费,注册与建 Key 都能免费完成;但要真正调用模型,需要先在账单页充值,首次购买最低 5 美元。
Q:新账号有没有免费额度?
A:官方计费文档把新 API 账号归入预付费模式,只以条件句说明「若账户有免费额度,会优先于充值额度消耗」,并未承诺固定赠送金额;以你自己账单页显示的余额为准。
Q:Key 丢了还能找回来吗?
A:不能。官方写明完整密钥只在创建时显示,丢失后只能在 API keys 页删除旧 Key 并新建一把,再更新应用配置。
Q:一个账号能建多少把 Key?
A:官方未给出 Key 的数量上限,但把 Key 按项目隔离;组织默认最多可创建 2,000 个项目,每个项目可各自管理密钥、模型白名单与速率限额。
Q:买了 ChatGPT Plus 会员能不能直接调 API?
A:不能。官方 Plus 帮助页明确「不包括:API 使用量另计并单独收费」,订阅与 API 是两套分开计费的产品。
Q:为什么密钥是对的却报 401?
A:官方列出四类常见原因:密钥有拼写错误或多出空格、密钥属于另一个组织或项目、密钥已被删除或停用、浏览器缓存了旧密钥。
Q:调用时报 429,是 Key 失效了吗?
A:不一定。要根据返回里的 code 区分:credit_balance_exhausted 是余额耗尽,此外还有请求过快、组织支出上限、项目支出上限、组织用量上限几种,处理方式完全不同。
Q:密钥需要设置有效期吗?
A:官方建议设。原文建议为密钥设置过期时间并建立定期轮换流程;管理员还可在组织或项目层面强制最长生命周期,且项目级上限不得超过组织级。
Q:在中国大陆可以申请和使用吗?
A:官方公布的支持地区名单不包含中国大陆、中国香港与中国澳门,并写明名单外访问可能导致账号被封停;未列入名单的地区,官方 API 不受支持。