Kyrifix
EN / 中文
产品
Getting Started

OpenAI API Key 开通（Journal）

这份流程只针对 platform.openai.com 的 API key，不是 ChatGPT 订阅。

1. 创建或确认 API 项目

  1. 登录 OpenAI Platform。
  2. 在组织中选择要使用的项目（Project）。
  3. 如果需要新项目，由组织 Owner 创建；项目成员可在项目内创建 key。

2. 创建 API key

  1. 打开 API Keys。
  2. 点击 + Create new secret key。
  3. 按需选择权限：
    • All
    • Restricted
    • Read Only
  4. 复制并安全保存密钥（建议立刻写入环境变量，不要落盘到源码）。

3. 开通计费（避免调用报额度错误）

  1. 打开 Billing Overview。
  2. 进入 API 组织的 Billing 页面添加支付方式。
  3. 如需预充值（Prepaid），在 Billing Overview 中点击 Add payment details，按提示购买额度。

4. 本地环境变量

export OPENAI_API_KEY="your_api_key_here"

5. 最小可用验证

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Return OK"
  }'

返回中出现模型输出即可视为 key 可用。

6. 常见问题（直接原因 -> 直接修复）

  • 现象：401 invalid_api_key
    • 直接原因：key 不存在/复制不完整/环境变量未生效。
    • 直接修复：重新生成 key，并在同一终端重新 export OPENAI_API_KEY=... 后重试。
  • 现象：429 或额度相关报错
    • 直接原因：API 计费未开通、余额不足或项目限额触发。
    • 直接修复：检查 Billing 与项目使用限制，补充余额或调整限制。
  • 现象：ChatGPT 已付费但 API 仍不可用
    • 直接原因：ChatGPT 订阅与 API Platform 计费是两套系统。
    • 直接修复：在 API Platform 单独完成 Billing 配置。

官方依据（2026-04-13 核对）