OpenAI API 密钥与服务账户
API 密钥是验证请求用的秘密凭据。服务账户是供应用或自动化工作负载使用的非人类身份,可以拥有一个或多个 API 密钥。选择凭据前,先确定发起请求的主体和它要操作的资源。
选择身份和凭据
| 使用场景 | 身份与凭据 | 权限归属 |
|---|---|---|
| 本地开发或个人探索 | 个人账号及其项目 API 密钥 | 请求使用你在该项目中的权限。 |
| 线上应用、定时任务、CI 工作流 | 项目服务账户及其 API 密钥 | 工作负载拥有独立身份,可单独调整权限和生命周期。 |
| 已接入 OpenAI 支持的身份提供商 | 项目服务账户与工作负载身份联合 | 工作负载可以在不保存长期 OpenAI API 密钥的情况下完成认证。 |
| 创建项目、管理其服务账户及密钥 | 管理员 API 密钥 | 通过管理 API访问组织级管理端点。 |
用户创建的密钥继承其所有者的权限。团队成员应使用各自的凭据,为长期运行的生产应用配置单独的服务账户。
每个服务账户归属一个项目。需要隔离资源、成员和用量时,可为不同应用或环境创建独立项目。只需区分同一个项目中的多个工作负载时,可以在该项目内为它们分配不同的服务账户。
理解角色和密钥范围
请求的有效权限同时受身份权限及密钥范围约束。密钥范围可以进一步限制访问。即使密钥设为不受限,其有效权限也不会超出用户或服务账户拥有的权限。
先为服务账户分配工作负载所需的最小角色,再收紧密钥权限。参见平台权限管理及在 Terraform 中管理项目服务账户。组织和项目的密钥策略同样适用于服务账户。
在受信任的管理服务中保存管理员密钥。已部署应用的模型请求由对应项目的服务账户凭据发起。
自动化项目和密钥管理
对需要为客户创建项目的应用,可由管理服务负责建立项目及身份,再向实际运行应用的服务发放项目凭据。
| 操作 | 用途 |
|---|---|
| 创建项目 | 建立负责存放资源与服务账户的项目。 |
| 创建服务账户 | 为项目中的工作负载建立身份。设置 create_service_account_only 可以跳过默认角色和初始密钥的创建。 |
| 为服务账户创建 API 密钥 | 为现有服务账户签发密钥,可按需配置权限范围及到期时间。 |
| 管理项目 API 密钥 | 可列出项目 API 密钥,也可按 ID 查询、更新或撤销现有密钥,包括服务账户的密钥。 |
如果只创建服务账户,须在它发起模型请求前补齐所需角色。以程序方式给工作负载发放密钥时使用服务账户。项目密钥管理接口不支持代其他用户创建个人项目密钥。
保存、轮换和撤销
服务账户密钥的完整值只在创建时返回。将其存入密钥管理服务,由服务端运行环境读取。浏览器代码、移动应用、代码仓库、日志及面向客户的响应都不应包含该值。
按组织和项目策略设置到期时间。轮换时先签发新密钥,在应用中替换并验证调用成功,然后撤销旧密钥。同一服务账户可以持续作为工作负载的身份。
工作负载职责变化时复核其权限。停用工作负载时撤销相应凭据。有关密钥管理和到期策略,参阅生产最佳实践。

TRAE-AI编程


更多建议: