OpenAI API Key 开通与安全使用指南(2026)
从创建 OpenAI API Key 到权限设置与安全实践的完整步骤,帮助你快速上线并避免常见风险。
1)在官方后台创建 Key
OpenAI 的 Key 在开发者平台(platform.openai.com)的 API Keys 页面创建。若用于生产环境,建议使用团队组织账号,不要使用临时个人账号。如果尚未注册,OpenAI API Key 教程 逐步讲解了账号注册、手机验证和计费设置。
创建后请立即保存到安全位置(例如密码管理器或密钥系统),不要把 Key 贴到聊天群、工单系统或公开文档。Key 字符串以「sk-」开头,通常为 51 个字符——如果你的 Key 看起来更短或被截断,可能是复制不完整。
为每个 Key 取一个能反映用途和环境的描述性名称,如「prod-backend-audit」或「dev-staging-test」。当团队成员更换角色或离职时,这能大大方便你判断该轮换或撤销哪个 Key。OpenAI 后台还支持将 Key 分配到特定项目,有助于消费追踪和访问隔离。
2)按最小权限原则配置
OpenAI 支持 Key 级权限(如 All、Restricted、Read Only)。生产环境建议优先使用 Restricted,仅开放业务实际需要的接口——例如你的应用只做文本生成和搜索,就只开「Chat Completions」和「Embeddings」。完整的 OpenAI API 参考指南 详细说明了各权限范围。
如果多个内部服务都会调用 OpenAI,建议为每个服务单独创建 Key,既便于审计,也能降低单点泄露影响。
一个常见错误是创建一个 All 权限的 Key 并在多个服务间共享。一旦某个服务被攻破,攻击者就能完全控制你的账号——包括删除模型、修改计费或耗尽额度。使用 Restricted Key 时,即使泄露也只暴露其授权的特定接口,能大幅降低潜在损失。
3)只在服务端使用密钥
不要把 OPENAI_API_KEY 暴露在前端代码中。正确做法是将 Key 放在服务端环境变量里,通过后端请求 OpenAI。如果不小心在前端代码中暴露了 Key,请立即在后台撤销并创建新 Key——应假设任何已暴露的 Key 都已被利用。
开发、测试、生产环境建议使用不同 Key。团队成员离职或疑似泄露时,要立刻轮换密钥。
以下是在 .env 文件中配置 Key 并在 Node.js 应用中加载的方法:
对于 Next.js,切记不要给环境变量加 NEXT_PUBLIC_ 前缀。带 NEXT_PUBLIC_ 前缀的变量会被打包到客户端 JavaScript 中,任何查看网页源代码的人都能看到。不带前缀的 OPENAI_API_KEY 变量只能在 Server Components 和 API 路由中访问,这正是你需要的。同时,持续监控用量有助于及时发现异常消费——尽早了解 API 成本 能避免月底的意外账单。
- 使用环境变量或密钥管理系统保存 Key
- 禁止把 Key 提交到 Git 仓库
- 建立固定轮换机制
# .env file
OPENAI_API_KEY=sk-your-key-here
# .gitignore — make sure .env is listed
.envOpenAI API Key 的环境变量配置
// Load the key from environment in Node.js
require('dotenv').config();
const { OpenAI } = require('openai');
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY, // never hardcode
});在 Node.js 中从环境变量加载 API Key
4)用最小请求完成首轮验证
在接业务逻辑之前,先用服务端 Key 发一个最小化测试请求,确认网络策略、项目配置和权限都正常。如果测试失败,你就知道问题出在认证或配置上——而不是应用代码。
建议记录请求 ID 与状态码,便于排查问题;同时对连续 401/429 建立告警。关于如何诊断这些错误——包括区分速率限制与额度耗尽以及实现安全重试策略——请参阅 排查 401 和 429 错误 指南。
首次配置时的一个常见陷阱是使用了错误的 base URL。API 端点是 https://api.openai.com/v1——不是 ChatGPT 的网址。另一个常见问题是忘记免费试用额度可能已过期,导致即使 Key 本身有效,也会收到 429「额度用尽」错误。
5)补齐运维防线
给项目设置预算并持续监控用量,尽早发现额度问题。流量上升时要结合速率限制策略,并实现指数退避重试。
密钥管理不是一次性动作,而是生产可用性的长期工作。建议建立季度密钥轮换机制,审查访问日志中的异常模式,并维护一份事件响应 Runbook,让团队在 Key 泄露时明确知道该做什么。
如果 Key 数量较多,可以考虑使用密钥管理服务。AWS Secrets Manager、HashiCorp Vault 或 Doppler 等工具能自动化轮换、审计访问记录,并与 CI/CD 管道集成——这样新部署会自动获取最新 Key,无需人工介入。
常见问题
所有服务共用一个 OpenAI Key 可以吗?
不建议。按服务或环境拆分 Key 更安全,出问题时也更容易定位和止损。
能把 OPENAI_API_KEY 放在前端代码里吗?
不能。前端暴露会导致 Key 泄露并产生未授权调用风险。
怀疑密钥泄露后应该怎么做?
第一时间轮换密钥,审计最近调用记录,并在恢复流量前收紧权限。
本系列相关
相关供应商
参考来源
- Assign API Key Permissions (OpenAI Help)OpenAI Help Center · 核验日期 2026-03-31
- OpenAI API Rate Limits GuideOpenAI Developers · 核验日期 2026-03-31
- OpenAI API Error CodesOpenAI Developers · 核验日期 2026-03-31