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"
    }
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号