OpenAI 创建项目服务账户
2026-11-17 18:24 更新
创建项目服务账户
post /organization/projects/{project_id}/service_accounts
在项目中创建新服务账户。默认情况下,还会返回该服务账户未经遮蔽的 API 密钥。
路径参数
project_id: string
项目 ID。
请求体参数
内容类型:application/json
name: string
要创建的服务账户名称。
create_service_account_only: optional boolean or null
创建服务账户,但不分配默认角色,也不创建 API 密钥。
expires_in_seconds: optional integer or null
初始 API 密钥过期前的秒数。省略或为 null 时,密钥不过期,除非有效的组织或项目策略要求设置过期时间。当策略规定最长有效期时,必须提供此值,且不能超过该上限。create_service_account_only 为 true 时,此值不能为非 null 值。
minimum: 1, maximum: 31536000
返回值
id: string
api_key: object { id, created_at, name, 3 more } or null
id: string
created_at: integer
format: unixtime
name: string
object: "organization.project.service_account.api_key"
对象类型,固定为 organization.project.service_account.api_key。
"organization.project.service_account.api_key"
value: string
expires_at: optional integer or null
API 密钥过期时间的 Unix 时间戳,单位为秒;不过期时为 null。
format: unixtime
created_at: integer
format: unixtime
name: string
object: "organization.project.service_account"
"organization.project.service_account"
role: "member" or "none"
创建时具有默认项目成员身份的服务账户,其角色为 member。使用 create_service_account_only 创建的账户,其角色为 none。
"member"
"none"
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/service_accounts" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-d '{
"name": "示例名称"
}'
200 — 示例
{
"id": "id",
"api_key": {
"id": "id",
"created_at": 0,
"name": "示例名称",
"object": "organization.project.service_account.api_key",
"value": "value",
"expires_at": 0
},
"created_at": 0,
"name": "示例名称",
"object": "organization.project.service_account",
"role": "member"
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects/proj_abc/service_accounts" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "生产应用"
}'
响应示例
{
"object": "organization.project.service_account",
"id": "svc_acct_abc",
"name": "生产应用",
"role": "member",
"created_at": 1711471533,
"api_key": {
"object": "organization.project.service_account.api_key",
"value": "sk-abcdefghijklmnop123",
"name": "密钥",
"created_at": 1711471533,
"id": "key_abc"
}
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: