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

TRAE-AI编程


更多建议: