OpenAI API 密钥与服务账户

2026-11-19 10:59 更新

API 密钥是验证请求用的秘密凭据。服务账户是供应用或自动化工作负载使用的非人类身份,可以拥有一个或多个 API 密钥。选择凭据前,先确定发起请求的主体和它要操作的资源。

选择身份和凭据

使用场景 身份与凭据 权限归属
本地开发或个人探索 个人账号及其项目 API 密钥 请求使用你在该项目中的权限。
线上应用、定时任务、CI 工作流 项目服务账户及其 API 密钥 工作负载拥有独立身份,可单独调整权限和生命周期。
已接入 OpenAI 支持的身份提供商 项目服务账户与工作负载身份联合 工作负载可以在不保存长期 OpenAI API 密钥的情况下完成认证。
创建项目、管理其服务账户及密钥 管理员 API 密钥 通过管理 API访问组织级管理端点。

用户创建的密钥继承其所有者的权限。团队成员应使用各自的凭据,为长期运行的生产应用配置单独的服务账户。

每个服务账户归属一个项目。需要隔离资源、成员和用量时,可为不同应用或环境创建独立项目。只需区分同一个项目中的多个工作负载时,可以在该项目内为它们分配不同的服务账户。

理解角色和密钥范围

请求的有效权限同时受身份权限及密钥范围约束。密钥范围可以进一步限制访问。即使密钥设为不受限,其有效权限也不会超出用户或服务账户拥有的权限。

先为服务账户分配工作负载所需的最小角色,再收紧密钥权限。参见平台权限管理及在 Terraform 中管理项目服务账户。组织和项目的密钥策略同样适用于服务账户。

在受信任的管理服务中保存管理员密钥。已部署应用的模型请求由对应项目的服务账户凭据发起。

自动化项目和密钥管理

对需要为客户创建项目的应用,可由管理服务负责建立项目及身份,再向实际运行应用的服务发放项目凭据。

操作 用途
创建项目 建立负责存放资源与服务账户的项目。
创建服务账户 为项目中的工作负载建立身份。设置 create_service_account_only 可以跳过默认角色和初始密钥的创建。
为服务账户创建 API 密钥 为现有服务账户签发密钥,可按需配置权限范围及到期时间。
管理项目 API 密钥 可列出项目 API 密钥,也可按 ID 查询、更新或撤销现有密钥,包括服务账户的密钥。

如果只创建服务账户,须在它发起模型请求前补齐所需角色。以程序方式给工作负载发放密钥时使用服务账户。项目密钥管理接口不支持代其他用户创建个人项目密钥。

保存、轮换和撤销

服务账户密钥的完整值只在创建时返回。将其存入密钥管理服务,由服务端运行环境读取。浏览器代码、移动应用、代码仓库、日志及面向客户的响应都不应包含该值。

按组织和项目策略设置到期时间。轮换时先签发新密钥,在应用中替换并验证调用成功,然后撤销旧密钥。同一服务账户可以持续作为工作负载的身份。

工作负载职责变化时复核其权限。停用工作负载时撤销相应凭据。有关密钥管理和到期策略,参阅生产最佳实践。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号