OpenAI 创建项目

2026-11-17 18:23 更新

创建项目

post /organization/projects

在组织中创建新项目。项目可以创建和归档,但不能删除。

请求体参数

内容类型:application/json

  • name: string

项目的易读名称,会显示在报告中。

  • external_key_id: optional string or null

要与项目关联的外部密钥 ID。

  • geography: optional string or null

使用指定的数据驻留区域创建项目。组织必须具备数据驻留功能的访问权限,才能使用此字段。有关该字段的功能与限制,请参阅平台数据控制文章中的数据驻留控制。 已弃用:请改用 residency。不要同时提供 geography 和 residency。

  • residency: optional ProjectResidency or null

使用指定的驻留配置创建项目。组织必须具备所请求驻留配置的访问权限,才能使用它。有关该字段的功能与限制,请参阅平台数据控制文章中的数据驻留控制。

  • "GLOBAL"

  • "US_STORAGE_PROCESSING"

  • "EU_STORAGE_PROCESSING"

  • "JP_STORAGE"

  • "JP_STORAGE_PROCESSING"

  • "KR_STORAGE"

  • "CA_STORAGE"

  • "SG_STORAGE"

  • "IN_STORAGE"

  • "IN_STORAGE_PROCESSING"

  • "AU_STORAGE"

  • "AU_STORAGE_PROCESSING"

  • "GB_STORAGE"

  • "AE_STORAGE"

  • "AE_STORAGE_PROCESSING"

返回值

  • Project object { id, created_at, object, 5 more }

表示单个项目。

  • id: string

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

  • created_at: integer

项目创建时间的 Unix 时间戳,单位为秒。

format: unixtime

  • object: "organization.project"

对象类型,固定为 organization.project。

  • "organization.project"

  • archived_at: optional integer or null

项目归档时间的 Unix 时间戳,单位为秒;未归档时为 null。

format: unixtime

  • external_key_id: optional string or null

与项目关联的外部密钥。

  • name: optional string or null

项目名称,会显示在报告中。

  • residency: optional ProjectResidency

项目的驻留配置。

  • "GLOBAL"

  • "US_STORAGE_PROCESSING"

  • "EU_STORAGE_PROCESSING"

  • "JP_STORAGE"

  • "JP_STORAGE_PROCESSING"

  • "KR_STORAGE"

  • "CA_STORAGE"

  • "SG_STORAGE"

  • "IN_STORAGE"

  • "IN_STORAGE_PROCESSING"

  • "AU_STORAGE"

  • "AU_STORAGE_PROCESSING"

  • "GB_STORAGE"

  • "AE_STORAGE"

  • "AE_STORAGE_PROCESSING"

  • status: optional string or null

active(活跃)或 archived(已归档)。

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects" \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "name": "示例名称"
        }'

200 — 示例

{
  "id": "id",
  "created_at": 0,
  "object": "organization.project",
  "archived_at": 0,
  "external_key_id": "external_key_id",
  "name": "示例名称",
  "residency": "GLOBAL",
  "status": "status"
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "项目 ABC"
  }'

响应示例

{
    "id": "proj_abc",
    "object": "organization.project",
    "name": "项目 ABC",
    "created_at": 1711471533,
    "archived_at": null,
    "status": "active"
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号