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
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: