OpenAI 上传证书

上传证书

post /organization/certificates

向组织上传证书。上传不会自动激活证书。

每个组织最多可上传50个证书。

请求体参数

内容类型：application/json

• certificate: string

PEM 格式的证书内容。

• name: optional string

可选的证书名称。

返回值

• Certificate object { id, certificate_details, created_at, 3 more }

表示已上传到组织的单个 certificate（证书）。

• id: string

标识符，可在 API 端点中引用。

• certificate_details: object { content, expires_at, valid_at }

• content: optional string

PEM 格式的证书内容。

• expires_at: optional integer

证书过期时间的 Unix 时间戳，单位为秒。

format: unixtime

• valid_at: optional integer

证书开始有效的时间，以 Unix 时间戳表示，单位为秒。

format: unixtime

• created_at: integer

证书上传时间的 Unix 时间戳，单位为秒。

format: unixtime

• name: string or null

证书名称。

• object: "certificate" or "organization.certificate" or "organization.project.certificate"

对象类型。

• 创建、更新或获取指定证书时，对象类型为 certificate。
• 列出组织证书，或为组织激活、停用证书时，对象类型为 organization.certificate。
• 列出项目证书，或为项目激活、停用证书时，对象类型为 organization.project.certificate。

• "certificate"

• "organization.certificate"

• "organization.project.certificate"

• active: optional boolean

证书当前是否在指定范围内处于激活状态。获取指定证书的详细信息时不返回此字段。

示例

## 使用环境变量中的管理员密钥；证书ID和PEM占位内容需换成实际值
curl https://api.openai.com/v1/organization/certificates \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "certificate": "certificate"
        }'

200 — 示例

译注：官方通用字段示例列出了 active；字段说明指出，获取指定证书详情时不返回该字段。下方保留原示例，不据此推断上传会自动激活。

以下为字段结构示例；字段名、证书ID和协议固定值按原文保留。

{
  "id": "id",
  "certificate_details": {
    "content": "content",
    "expires_at": 0,
    "valid_at": 0
  },
  "created_at": 0,
  "name": "示例证书名称",
  "object": "certificate",
  "active": true
}

示例

## 使用环境变量中的管理员密钥；证书ID和PEM占位内容需换成实际值
curl -X POST https://api.openai.com/v1/organization/certificates \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
  "name": "我的示例证书",
  "certificate": "-----BEGIN CERTIFICATE-----\\nMIIDeT...\\n-----END CERTIFICATE-----"
}'

响应示例

以下为对应请求的响应示例。时间值和证书内容仅作结构展示。

{
  "object": "certificate",
  "id": "cert_abc",
  "name": "我的示例证书",
  "created_at": 1234567,
  "certificate_details": {
    "valid_at": 12345667,
    "expires_at": 12345678
  }
}