OpenAI API Key 完全指南(2026):开通、定价、排错与最佳实践
关于 OpenAI API Key 你需要知道的一切:如何创建、配置权限、理解定价、排查 401/429 错误,以及安全最佳实践。
什么是 OpenAI API?
OpenAI API 让开发者可以通过编程方式调用 OpenAI 的语言模型,包括 GPT-4o、GPT-4 Turbo、o 系列推理模型和 DALL-E 图像生成。你不需要使用 ChatGPT 网页版,而是直接将这些模型集成到自己的应用、服务或工作流中。
API Key 是你向 OpenAI API 发送请求时的身份凭证。没有有效的 Key,每个请求都会被拒绝并返回 401 错误。本指南覆盖 Key 的完整生命周期:创建、配置、使用、定价、排错和安全。
如何获取 OpenAI API Key
获取 OpenAI API Key 大约需要五分钟。首先在 OpenAI 开发者平台注册账号,完成邮箱和手机号验证后,进入后台的 API Keys 页面。
点击「Create new secret key」,给 Key 起一个可识别的名字(如「production-server」或「dev-testing」),然后立即复制保存。关闭弹窗后你将无法再次查看该 Key。
- 第 1 步:在 platform.openai.com 注册
- 第 2 步:验证邮箱和手机号
- 第 3 步:进入后台 API Keys 页面
- 第 4 步:点击「Create new secret key」
- 第 5 步:立即复制并安全保存 Key
配置 API Key 权限
OpenAI 支持 Key 级权限模式:All、Restricted 和 Read Only。生产环境建议始终使用 Restricted 模式,仅开放业务实际需要的接口。
如果多个内部服务都会调用 OpenAI,建议为每个服务单独创建 Key。这样出问题时更容易定位和止损,也便于审计。
OpenAI API 定价说明
OpenAI 按 token 计费,不是按请求次数。输入 token(你发送的内容)和输出 token(模型生成的内容)分别计价。不同模型价格不同——GPT-4o 比 GPT-4o-mini 贵,o 系列推理模型因为扩展思考能力定价更高。
你可以在后台设置月度消费上限,避免意外账单。新账号有时会获得免费试用额度,但有有效期,不应依赖它跑生产。
常见错误:401 和 429
401 错误表示认证失败——你的 Key 无效、已撤销或未正确发送。检查是否在 Authorization 头中以 Bearer token 方式传递。
429 错误表示超过速率限制。OpenAI 同时限制单次请求和每分钟请求数。建议实现指数退避重试,如果持续超限可以考虑升级账户等级。
安全最佳实践
永远不要把 OpenAI API Key 暴露在前端代码、公开仓库或客户端环境变量中。始终从后端服务器调用 API。
定期轮换密钥,团队成员离职或疑似泄露时立即轮换。开发、测试、生产环境使用不同 Key。
- 使用环境变量或密钥管理系统保存 Key
- 禁止把 Key 提交到 Git 仓库
- 开发/测试/生产环境使用不同 Key
- 设置消费告警和月度上限
- 监控用量,关注异常波动
ChatGPT API Key 和 OpenAI API Key 的区别
不存在单独的「ChatGPT API Key」。ChatGPT 是基于 OpenAI API 构建的产品。你在 OpenAI 开发者平台创建的 Key 就是用来通过编程方式调用 GPT 模型的 Key,无论你叫它「ChatGPT API Key」还是「OpenAI API Key」。
如果你在找「ChatGPT API Key」,你实际需要的是从 platform.openai.com 获取的 OpenAI API Key。
常见问题
OpenAI API Key 是免费的吗?
创建 API Key 是免费的,但使用 API 需要按 token 用量付费。新账号可能会获得有限的免费试用额度。
ChatGPT 和 API 可以用同一个 Key 吗?
ChatGPT Plus 订阅和 OpenAI API 是两套独立的计费系统。ChatGPT Plus 订阅不包含 API 额度,API Key 也不能用于访问 ChatGPT Plus 功能。
遇到 401 错误怎么办?
检查 API Key 是否有效、未被撤销,并确保以 Bearer token 方式正确传递在 Authorization 头中。同时检查 Key 字符串中没有多余的空格或换行。
如何查看 OpenAI API 用量?
登录 OpenAI 开发者平台,查看 Usage 页面。你可以看到每日 token 消耗、按模型的成本明细,并设置账单告警。
本系列指南
相关供应商
参考来源
- OpenAI API Keys DocumentationOpenAI Platform · 核验日期 2026-07-29
- OpenAI API PricingOpenAI · 核验日期 2026-07-29
- OpenAI API Rate LimitsOpenAI Platform · 核验日期 2026-07-29