OpenAI 为服务账户创建 API 密钥
2026-11-17 18:24 更新
为服务账户创建 API 密钥
post /organization/projects/{project_id}/service_accounts/{service_account_id}/api_keys
为项目中的服务账户创建 API 密钥。
路径参数
project_id: string
项目 ID。
service_account_id: string
服务账户 ID。
请求体参数
内容类型:application/json
expires_in_seconds: optional integer or null
API 密钥过期前的秒数。
minimum: 1, maximum: 31536000
name: optional string
API 密钥名称。
scopes: optional array of string
API 密钥的权限范围。
返回值
id: string
API 密钥标识符。
created_at: integer
API 密钥创建时间的 Unix 时间戳,单位为秒。
format: unixtime
name: string
API 密钥名称。
object: "organization.project.service_account.api_key" (default: "organization.project.service_account.api_key")
对象类型,固定为 organization.project.service_account.api_key。
"organization.project.service_account.api_key"
value: string
未经遮蔽的 API 密钥值。
expires_at: optional integer or null
API 密钥过期时间的 Unix 时间戳,单位为秒;不过期时为 null。
format: unixtime
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/service_accounts/$SERVICE_ACCOUNT_ID/api_keys" \
-X POST \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"
200 — 示例
{
"id": "id",
"created_at": 0,
"name": "示例名称",
"object": "organization.project.service_account.api_key",
"value": "value",
"expires_at": 0
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects/proj_abc/service_accounts/svc_acct_abc/api_keys" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "生产应用",
"scopes": ["api.responses.write"]
}'
响应示例
{
"object": "organization.project.service_account.api_key",
"value": "sk-abcdefghijklmnop123",
"name": "生产应用",
"created_at": 1711471533,
"id": "key_abc"
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: