如何获取 OpenAI API Key:platform.openai.com 注册、计费、生成密钥与第一条 curl
注册 OpenAI 平台账号、开通计费、生成 API key,用 curl 发出第一条请求并读懂 rate limit 报错。
你要在代码里调用 GPT,而不是只在 ChatGPT 网页里聊天。官方路径是 platform.openai.com:注册账号 → 绑定 Billing → 生成 API key → 用 curl 发出第一条 chat/completions 请求。步骤以 OpenAI Quickstart 与 Authentication 为准。
可检索主题是 如何获取 OpenAI API Key 并完成第一条 API 请求:账号、计费、密钥、curl 示例,以及 rate limits 怎么读。定价与 tier 以平台 Billing / Limits 页面为准,不用第三方转述表。
先分清平台入口与 ChatGPT
platform.openai.com
开发者控制台:Billing、API keys、Usage、Limits。REST API 调用走 api.openai.com。
chatgpt.com
面向终端用户的 ChatGPT 网页/应用。Plus 订阅不等于 API 额度;API 按用量单独计费。
| 步骤 | 官方位置 | 常见卡点 |
|---|---|---|
| 注册 / 登录 | platform.openai.com | 需可用邮箱;部分地区可能受限,以注册页提示为准 |
| 绑定 Billing | Settings → Billing | 未绑卡时 API 可能无法调用或额度极低 |
| 创建 API key | Settings → API keys → Create | 密钥只显示一次;丢失需新建并轮换旧 key |
| 第一条请求 | POST /v1/chat/completions | 401 查 Authorization 头;429 查 rate limits |
从注册到第一条 curl
- 01在 platform.openai.com 注册账号
浏览器打开 platform.openai.com,用邮箱或支持的 OAuth 方式注册并验证邮箱。登录后进入 Dashboard。官方 Quickstart 把「Sign up / Log in」列为第一步。
- 02设置 Billing(支付方式)
进入 Settings → Billing,按页面提示添加支持的信用卡或其他支付方式。API 按 token 用量计费;具体价格见 Pricing。Billing 未就绪时,调用可能失败或额度受限。
- 03生成 API key
Settings → API keys → Create new secret key。复制并保存在密码管理器里;官方 Authentication 文档强调密钥等同于密码,不要写入 Git 或前端 bundle。可为不同项目创建多个 key 并单独撤销。
- 04用 curl 发送第一条 Chat Completions 请求
在终端把
$OPENAI_API_KEY设为刚复制的密钥,然后请求https://api.openai.com/v1/chat/completions。成功时 JSON 的choices[0].message.content会有模型回复。 - 05读懂 rate limits 与 429
官方 Rate limits 指南说明每个模型有 RPM 与 TPM 上限,响应头含
x-ratelimit-remaining-requests等字段。收到 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头与 Settings → API keys 里 key 状态为 Active。 - 429 Too Many Requests
- 触达 RPM/TPM 限制。读响应头与 retry-after;官方 Rate limits 文档建议指数退避重试。
- 403 或 model not found
- 账户 tier 可能无权访问该模型。改 Quickstart 推荐的默认可用模型,或查看 Limits 页面。
先跑通一条最小 curl,再接入 Cline、Cursor 或自研服务。密钥泄露比选错模型更贵——轮换 key 比追账单便宜。
API 集成要对齐时
OpenAI API 走 HTTP;IDE 里的 Copilot 或 Cursor Agent 是另一条路。要把 endpoint、模型和 rate limit 截图对齐,可以摊在同一页。用 oakmeet 开一间会过期的房:浏览器、空间码、不用注册。上限见 八人、大约一小时。可对照 Google AI Studio 与 Cline 自带密钥。
ChatGPT Plus 包含 API 额度吗?
不包含。Plus 是 chatgpt.com 的订阅;API 在 platform.openai.com 单独按用量计费。以 OpenAI 官方 Pricing 与 Billing 说明为准。
免费层还能用 API 吗?
政策与额度会变。以注册后 Billing 与 Limits 页面显示为准;不要依赖过时的「$5 免费额度」截图。
密钥泄露了怎么办?
立即在 Settings → API keys 撤销该 key 并新建。官方 Authentication 文档建议定期轮换,且 never commit keys to version control。
Rate limit 能申请提高吗?
官方 Rate limits 指南说明额度随 Usage tier 提升;在 Settings → Limits 查看当前 tier 与申请路径(若页面提供)。