OpenAI 列出项目

2026-11-17 18:23 更新

列出项目

get /organization/projects

返回项目列表。

查询参数

  • after: optional string

分页游标。after 是标记列表位置的对象 ID。例如,列表请求返回100个对象,最后一个为 obj_foo;后续调用可传入 after=obj_foo,以获取下一页。

  • include_archived: optional boolean (default: false)

为 true 时返回所有项目,包括状态为 archived 的项目。默认不包含已归档项目。

  • limit: optional integer (default: 20)

返回的对象数量上限。取值范围为1至100,默认值为20。

返回值

  • data: array of Project

  • 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(已归档)。

  • has_more: boolean

  • object: "list"

  • "list"

  • first_id: optional string or null

  • last_id: optional string or null

示例

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

200 — 示例

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "object": "organization.project",
      "archived_at": 0,
      "external_key_id": "external_key_id",
      "name": "示例名称",
      "residency": "GLOBAL",
      "status": "status"
    }
  ],
  "has_more": true,
  "object": "list",
  "first_id": "first_id",
  "last_id": "last_id"
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects?after=proj_abc&limit=20&include_archived=false" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

响应示例

{
    "object": "list",
    "data": [
        {
            "id": "proj_abc",
            "object": "organization.project",
            "name": "示例项目",
            "created_at": 1711471533,
            "archived_at": null,
            "status": "active"
        }
    ],
    "first_id": "proj-abc",
    "last_id": "proj-xyz",
    "has_more": false
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号