先选 Organization，再选 Project。Organization 管理组织成员、顶层账单和全部项目；Project 管理具体应用或环境的成员、Key、Service Account、文件与 Assistant 等资源、模型访问、速率和支出限制。个人 API Key 不应该跨项目混用，生产与测试也建议分开。
官方参考（2026-10-29 核对）：OpenAI：Managing projects · Project-based API keys 与协作 · Admin API 能力
一张表看懂 Organization 与 Project
| 项目 | Organization | Project |
|---|---|---|
| 定位 | API Platform 顶层容器 | 组织内部的应用、产品或环境单元 |
| 角色 | Owner、Reader 等组织级角色 | Owner、Member 等项目级角色 |
| API Key | 组织 Owner 可管理和查看项目范围 | 用户和 Service Account 的 Key 受项目作用域约束 |
| 资源 | 承载多个项目与总览 | 文件、Assistant、Thread、Storage、Fine-tuning 等通常按项目隔离 |
| 限制 | 组织级批准用量、账单和顶层控制 | 模型访问、速率、Spend Limit、Usage 归因 |
| 常见用途 | 公司、主体或统一账单范围 | 生产/测试、不同产品、不同客户或成本中心 |
Organization：成员、全局管理与账单边界
Organization Owner 可以创建和查看全部项目，管理组织成员，并设置组织及项目层级的控制。Reader 可以加入项目并在获授权的项目中创建 Key、调用资源，但不能创建项目或管理组织用户。
如果账户属于多个 Organization，先在控制台确认当前组织。不同组织可能拥有不同项目、余额、使用层级和限额；在错误组织中创建 Key，往往会导致“控制台有资源、代码却访问不到”的错觉。
Project：把应用、环境和成本分开
Project 适合按产品、生产/测试环境或成本中心拆分。每个 Project 可以分别管理成员、Service Account、API Key、模型访问、速率、Usage 和支出限制。官方允许用户加入多个项目，但个人 Key 仍绑定其创建所在的 Project。
哪些资源通常属于 Project
- API Keys 与 Service Accounts
- Files、Assistants、Threads 与 Storage
- Fine-tuning、模型访问与部分能力配置
- Usage 归因、速率设置、Spend Limit 与告警
资源不能随意在 Project 之间移动。调用代码、Key 和资源 ID 必须处于正确边界；否则可能出现 403、资源不存在或 Usage 记到错误项目。
Default Project 有什么特殊之处
每个 Organization 都包含不能删除的 Default Project。它继承组织完整配置，可配置模型、速率和支出限制；但不能像普通 Project 一样直接添加成员或 Service Account。邀请组织成员时，需要明确是否授予 Default Project 访问。
对正式业务，更建议建立有明确名称的生产 Project，而不是把所有系统永久堆在 Default Project。这样更容易定位调用、轮换 Key、控制预算和处理成员离职。
角色和权限怎么分
| 角色 | 范围 | 主要能力 |
|---|---|---|
| Organization Owner | 整个组织 | 创建/查看全部项目，管理组织用户与组织/项目控制 |
| Organization Reader | 组织成员 | 加入获授权项目，执行调用和创建项目级 Key；不能管理组织用户 |
| Project Owner | 单个项目 | 管理项目成员、设置、支出限制与归档 |
| Project Member | 单个项目 | 调用 API、使用资源并创建项目级 Key |
| Service Account | 单个项目 | 代表服务器或自动化系统，不代表具体个人 |
成为 Project Owner 不代表自动拥有组织级 Usage Dashboard 可见权限；可见性还取决于 Organization 角色和 Usage Dashboard 设置。
生产、测试和多人协作的推荐结构
- 同一公司主体使用一个合适的 Organization。
- 为生产、测试和不同产品创建独立 Project，例如
product-prod、product-staging。 - 把人员先加入 Organization，再按最小权限加入对应 Project。
- 服务器使用项目级 Service Account Key；开发者使用自己的项目级 Key。
- 为每个 Project 单独设置模型访问、速率、Spend Limit 与告警。
- 监控 Usage 时按 Project 筛选，避免多个应用共用同一 Key。
OpenAI 明确建议团队不要共享个人 Key，而应使用 Project-based API keys、独立环境和项目级 Usage 控制。
遇到 401、403、429 时从哪里查
- 401：先检查 Key、Authorization 和部署环境变量，参阅API 401/403 排查。
- 403：检查 Key 所属 Project、资源归属、角色和 Restricted 权限。
- 429：检查 Organization/Project 的速率、Credits、批准用量和硬性 Spend Limit，参阅API 速率限制指南。
- 账单错误：查看API Credits和API 付款失败。
Project 归属错误的排查清单
- 确认控制台当前 Organization 和代码实际使用的 Key 属于同一组织。
- 确认 Key 创建于目标 Project，且未被撤销或替换。
- 确认文件、Assistant、Thread、向量存储或 Fine-tuned model 的创建 Project。
- 检查项目成员角色、Service Account、Key 权限和模型访问。
- 检查 Usage、速率与 Spend Limit 是否查看了同一 Project。
- 修复后重新部署，避免 Preview 和 Production 仍引用旧 Key。
创建批处理前先确认正确的 Organization、Project 和 API Key，再按OpenAI Batch API 教程记录批次、文件与成本归属，避免跨项目找不到资源。
跨 Project 的 Key 可能找不到资源；创建、摄取、查询和删除流程见 OpenAI File Search 指南。
Embedding 模型、维度、metadata 和 ACL 设计见 OpenAI Embeddings API 教程。
常见问题
OpenAI API Organization 和 Project 的核心区别是什么？
Organization 是 API Platform 的顶层管理与账单边界，管理成员、组织级角色和全部项目；Project 是组织内部的工作单元，用来隔离 API Key、成员、Service Account、资源、模型访问、速率、Usage 和支出设置。
一个 API Key 可以访问另一个 Project 的资源吗？
项目内创建的个人 API Key 受该项目及其资源范围约束。文件、Assistant、Thread、存储等资源通常属于创建它们的 Project，不能把一个项目的 Key 当作全组织通用密钥。
Default Project 可以删除或添加成员吗？
官方说明每个 Organization 都有不能删除的 Default Project。它继承组织的完整配置，不能像普通项目一样直接添加成员或 Service Account；邀请组织成员时可选择是否给予 Default Project 访问。
Project Owner 和 Organization Owner 有什么区别？
Organization Owner 可创建和查看全部项目、管理组织用户及组织/项目限制；Project Owner 主要管理所属项目成员、设置、支出限制和归档。Project Owner 并不自动获得组织级 Usage Dashboard 的可见权限。
Service Account 应该建在 Organization 还是 Project？
Service Account 是面向系统的身份，按 Project 隔离。生产、测试和不同应用应创建各自的 Project 与 Service Account，不应多人共享个人 API Key。
项目归属错误为什么会出现 403 或资源找不到？
Key、成员权限与文件、Assistant、Thread、向量存储等资源都可能绑定 Project。请求若使用了另一项目的 Key 或错误的组织/项目上下文，就可能没有权限或找不到资源；应先确认资源创建位置和实际使用的 Key。
按 Organization 管主体，按 Project 管应用
把生产、测试和不同产品拆开，使用项目级 Service Account 和最小权限 Key，可以同时改善安全、账单归因和限流排查。
生产服务需要独立系统身份时，请参考 OpenAI API Service Account 创建与轮换指南。
查看项目 Token 与成本时，请参考 OpenAI API Usage 查询指南。
遇到服务端错误或连接超时时，请参考OpenAI API 500/503与超时排查。