小白入门

ChatGPT API 怎么用:国内获取 OpenAI API key 的完整步骤(手机验证、充值、第一次调用)

一句话结论:获取 ChatGPT API key 要走 OpenAI 官方 API Platform:先确认访问地区受支持,创建首个 key 时完成手机验证,再单独设置 API 预付费余额。ChatGPT Plus 订阅与 API 账单分开,key 只放环境变量,不要写进代码或发给别人。

很多人把“ChatGPT 会员”和“ChatGPT API”当成同一件事,结果拿着 Plus 订阅去找 API key,或者充值后仍然调用失败。先说结论:API key 要在 OpenAI API Platform 创建,首个 key 可能卡在地区和手机验证,API 余额也要单独设置。本文只讲官方 API,不提供中转地址、共享 key 或代开账号。

本文于 2026-11-05 核对了4个入口;示例不含key。

一、开始前先确认三个前提

第一,访问地区必须在 OpenAI 当前的支持国家、地区和领土列表中。从不支持地区访问,账号可能被封禁或暂停;若报 unsupported_country_region_territory,先处理地区问题,不要先充值。

第二,准备一个你能长期控制的受支持移动号码。OpenAI 的手机验证说明写明,首次生成 API key 必须验证;座机、VoIP、Google Voice 和 premium 号码不受支持。

第三,准备独立的 API 付款方式和安全的运行环境。API Platform 与 ChatGPT 订阅账单分开,Plus 或 Pro 不会自动变成 API 余额。

二、创建 OpenAI API key

按下面顺序操作:

  1. 打开 API Platform,登录或创建 OpenAI 账号;
  2. 出现地区不支持时先停止,核对支持列表和网络出口;
  3. 进入 API key 页面创建 secret key,首次创建按页面完成手机验证;
  4. 复制 key 到安全位置,不要再把它发给任何人。

OpenAI 官方 Developer Quickstart建议把 key 导出为环境变量。不要把 key 写进代码、前端 JavaScript、截图或公开仓库;网页前端不应持有长期 secret key。

三、API 充值和 ChatGPT 订阅要分开

新 API 账号使用预付费模式。打开 API 组织的 Billing 页面,添加支付信息并购买 credits;官方当前说明最低购买金额为 5 美元、默认金额为 10 美元,自动充值默认开启,不需要时要关闭。已购买 credits 一年后过期,充值前先确认组织和支付方式。

购买完成后余额可能需要几分钟更新。若已扣款但余额不对,先检查 API organization 和购买记录,不要连续购买。余额耗尽时可能返回 credit_balance_exhausted,回到 API Billing 页面选择 Buy credits 或 Add to credit balance。

ChatGPT Plus/Pro 订阅不等于 API prepaid credits;auto-reload 只是自动购买余额,也不是 API 使用上限。

具体账单入口和规则会调整,付款前以官方预付费账单说明为准。

四、用 Python 发出第一次请求

电脑已经安装 Python 后,先安装官方 Python SDK:

python -m pip install openai

在 macOS 或 Linux 终端设置环境变量:

export OPENAI_API_KEY="你的真实 API key"

Windows PowerShell 可以用:

setx OPENAI_API_KEY "你的真实 API key"

新开终端,保存下面的 first_call.py 并运行。模型名称会变化;若提示模型不可用,换成账号可用的模型。

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-6-astra",
    input="请用一句话解释 API key 是什么。",
)

print(response.output_text)

如果返回文本,说明环境变量、key、余额和接口已连通。不要把返回结果中的请求 ID、账号信息或 key 发到公开论坛。

五、第一次调用失败怎么判断

先看错误里的 code、HTTP 状态和时间,不要看到失败就马上换 key:

现象优先检查
unsupported_country_region_territory访问地区、网络出口和官方支持列表
invalid_api_key 或认证失败环境变量是否在当前终端生效、key 是否复制完整、是否误用了 ChatGPT 登录密码
credit_balance_exhaustedAPI organization 的 prepaid credits 是否已耗尽
429、速率或使用上限提示请求频率、token 限制、组织或项目 spend limit

OpenAI 的账单与使用上限排查说明提醒,有正余额也可能触发其他限制。联系支持时提供时间、错误码和 request ID,并遮掉 key、手机号和支付信息。

六、API key 的安全底线

一个 key 泄露后,余额、请求内容和项目权限都可能暴露:

  • 只在服务端或本地环境变量中读取,不放前端代码;
  • 为不同项目使用不同 key,项目结束后及时撤销;
  • 不把 .env、终端截图、CI 日志和 key 一起提交到 Git;
  • 发现泄露先撤销旧 key,再检查用量和账单,不要只生成新 key 而留下旧 key。

团队协作时,让组织所有者管理 Billing、项目和权限,比把一个 key 发到群里更容易追责。

七、相关阅读

如果你已经进入 OpenAI 的手机验证页面,只差一次收码,可以查看 YoTradeApi 美国号验证码代收:微信付款,不用注册和充值,收不到会自动换号,换号仍失败全额退款;它不能解决地区不支持,也不能替代 OpenAI API 的官方账单。

常见问题

ChatGPT Plus 订阅包含 OpenAI API 额度吗?

不包含。ChatGPT 订阅和 API Platform 是两套独立的计费系统,API 需要在 API 组织的账单页面单独设置。

创建第一个 OpenAI API key 要手机验证吗?

要。OpenAI 官方说明,在 platform.openai.com 生成初始 API key 必须完成手机验证,后续生成 API key 不重复要求这一项。

OpenAI API 充值后余额为什么还没显示?

官方说明成功购买后余额可能需要几分钟更新;如果仍不匹配,应先检查 API 组织和购买记录,再联系官方支持,不要重复购买。

API key 应该放在哪里?

放在操作系统环境变量 OPENAI_API_KEY 中,让官方 SDK 自动读取;不要把真实 key 写进代码、提交到 Git 或贴到聊天窗口。

余额充足但 API 仍然报错怎么办?

余额不等于没有其他限制,还要区分模型、请求或 token 速率限制、组织使用上限和项目 spend limit,并按错误码排查。