OpenAI API Key 教程：platform.openai.com 账号、Billing、Secret Key 与用量限制

platform 账号 → Billing → 创建 Secret Key → 一条冒烟请求 → 读懂 Limits 与 429。

你要拿到可用于代码与集成的 OpenAI API Key，而不只是 chatgpt.com 网页聊天。官方路径：platform.openai.com 账号 → Settings → Billing 开通按量计费 → Settings → API keys 创建 Secret Key → 在 Usage 与 Limits 查看 RPM/TPM 上限。步骤以 Quickstart、Authentication、Rate limits 为准。

可检索主题是 OpenAI API Key：platform.openai.com 账号、Billing、创建 Secret Key、用量与限速基础。以控制台 Billing、Usage、Limits 为准，不用第三方额度表。ChatGPT Plus 不包含 API 额度。

平台与 ChatGPT 的区别

账号、Billing 与 Secret Key

1. 01
   注册 platform.openai.com 账号

   用邮箱或支持的 OAuth 注册，验证邮箱后进入 Dashboard。Quickstart 第一步即 Sign up / Log in。团队可在一个 Organization 下协作并邀请成员。

2. 02
   设置 Billing

   打开 Settings → Billing，为组织添加支持的支付方式并开通按量计费。API 按 token 计费（Pricing）。发票与用量在此管理，不在 chatgpt.com 的 Settings。

3. 03
   创建 Secret API Key

   Settings → API keys → Create new secret key。立即复制到密码管理器。Authentication 文档要求 Bearer 头，禁止写入 Git 或前端 bundle。不同应用用不同密钥，便于单独撤销。

4. 04
   冒烟测试一条请求

   在本地设置 $OPENAI_API_KEY，向 https://api.openai.com/v1/chat/completions POST，或使用 Playground。成功时 choices[0].message.content 有回复且 Usage 增加。

5. 05
   读懂用量与限速基础

   Rate limits 说明 RPM 与 TPM。关注 x-ratelimit-remaining-* 响应头。429 时遵守 retry-after 或降低并发。Settings → Limits 显示组织长期上限。

export OPENAI_API_KEY="sk-..."  # 切勿提交到 Git

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Say hello in one word."}]
  }'

常见失败点

401 Unauthorized

密钥缺失、拼错或已撤销。检查 Authorization: Bearer 与 API keys 页的 Active 状态。

429 Too Many Requests

触达 RPM/TPM。读响应头与 retry-after；Rate limits 文档建议指数退避。

403 或 model not found

当前 Usage tier 可能不含该模型。换 Quickstart 默认模型或查看 Limits。

Billing 未就绪

调用失败或 Usage 始终为零——打开 Settings → Billing 确认组织计费状态。

密钥泄露先轮换，再讨论模型。一条最小请求加 Usage 比盲目接 IDE 更快确认 Billing 与 Limits。