在 API 平台中管理项目

概述

项目用于组织 API 组织内的工作。你可以使用项目，为一组特定资源管理访问权限、配置模型限制和速率限制、创建服务账户，并跟踪用量、账单和支出限额。这些资源包括模型、功能、线程、助手、微调和存储等。

组织所有者可以在项目页面查看所有活跃项目和已归档项目。

开始之前

你需要具有组织所有者角色才能创建项目。默认情况下，每个组织最多可以创建 2,000 个项目。

如果你的组织使用合并账单，子组织会在组织选择器中单独列出。你无法在子组织中创建项目。

如需切换组织，请打开组织选择器，然后选择要使用的组织。

默认项目

每个组织都包含一个默认项目，且无法删除。默认项目会继承组织的全部配置。你可以配置其速率限制、虚拟模型权限和支出限额。

你无法直接将成员或服务账户添加到默认项目。你可以按照本文中的组织邀请步骤，在邀请他人加入组织时，同时授予默认项目的访问权限。

创建项目

1. 打开项目选择器，然后选择创建项目。

2. 输入项目名称、描述和网站。

3. 选择创建。

组织所有者会自动成为新项目的所有者。

了解角色和访问权限

下表概述了这些步骤中涉及的组织所有者和读取者角色，以及项目所有者和成员角色。项目成员的权限与组织读取者类似。

有关组织角色的详细信息，请参阅组织角色。有关其他角色、自定义角色和完整权限的信息，请参阅 API 角色和权限指南。

项目可见性

在这些标准角色下，非组织所有者的用户只能看到自己所属的项目。组织所有者可以查看所有项目、成员和项目级 API 密钥，并且可以访问项目页面。

项目成员可以查看同一项目的其他成员及每位成员的角色。只有项目成员和组织所有者可以查看在该项目内创建或添加的微调模型、助手线程和文件。

你可以根据需要加入任意数量的项目。在项目内创建的个人 API 密钥仅适用于该项目及其资源。

资源边界

文件、助手、存储和线程的使用范围均限定在其所属项目内。不属于该项目的非管理员成员无法访问其资源，资源也不能在项目之间移动。

默认项目中的微调模型是例外：其他项目可以访问这些模型。

管理项目成员

邀请他人加入你的组织

邀请他人加入组织时，你可以在邀请表单中勾选相应选项，同时授予默认项目的访问权限。如果不想授予默认项目的访问权限，请不要勾选该选项。新加入组织的成员不会自动加入默认项目。

邀请他人之前，无需另建项目。你也可以在对方接受组织邀请后，再将其添加到项目中。

通过管理 API 发送的邀请遵循 /organization/invites 端点的规则。

将组织成员添加到项目

组织所有者和项目所有者可以添加成员：

1. 前往组织设置。

2. 选择项目，然后打开成员。

3. 选择 + 添加成员。

4. 选择用户，并为其分配成员或所有者角色。

用户列表显示组织中具有读取者角色的用户。该列表不包含服务账户。

如果通过界面或管理 API 发送邀请失败，请先确认目标项目存在且未归档，再重新发送邀请。

更改角色或移除成员

组织所有者和项目所有者可以更改用户的项目角色，或将用户从该项目中移除。

1. 前往组织设置。

2. 选择项目，然后打开成员。

3. 将用户角色设为成员或所有者，或选择移除将其移除。

创建和管理服务账户

服务账户用于提供系统访问权限，而不是代表某个个人用户。服务账户的使用范围限定在所属项目内。

创建服务账户需要服务账户管理权限。组织所有者和项目所有者拥有这些权限。

创建服务账户

1. 在项目选择器中选择项目。

2. 前往组织设置并选择项目。

3. 打开成员，然后选择 + 服务账户。

4. 输入由字母、数字和连字符组成的唯一服务账户 ID。

5. 选择创建。

无论通过组织级还是项目级设置创建服务账户，都使用相同的 ID 格式。

为项目创建的服务账户专属于该项目，无法在项目之外使用。

保存密钥

创建服务账户时，系统会立即创建 API 密钥并显示其密钥值。请妥善保存密钥。之后，你将无法通过 OpenAI 账户再次查看该密钥。如果丢失，请生成新密钥。

默认情况下，服务账户密钥可以读写所属项目中的所有 API 资源。之后，你可以在项目的 API 密钥设置中更改这些权限。

服务账户会与用户一起显示在项目的成员设置中。你可以按照与其他项目成员相同的角色更改和移除步骤，管理服务账户的项目访问权限。

所有服务账户也会与用户一起显示在组织的成员页面上，包括通过组织级和项目级设置创建的账户。

在组织的成员菜单中，你可以更改服务账户的角色，或选择移除。

创建和管理 API 密钥

每个项目都有各自的 API 密钥：

1. 前往组织设置。

2. 选择项目，然后打开 API 密钥。

3. 选择 + 创建新密钥以创建密钥，或选择现有密钥旁的编辑图标以更改其权限。

选择密钥权限

对于用户拥有的密钥，你可以在创建时设置权限，也可以稍后编辑：

• 全部：拥有完整权限。这是默认设置。

• 受限：为特定资源或端点选择权限范围。可用选项因资源而异，可能包括无、读取、写入或针对特定请求的权限。

• 只读：拥有所有端点的读取权限。

例如，可以让受限密钥不具有 /v1/assistants 端点的读写权限。

创建服务账户密钥需要服务账户管理权限。如果你看不到该选项，请联系组织所有者或项目所有者，让其创建服务账户密钥。创建服务账户密钥时，密钥创建对话框不会显示这些权限控件；请在创建后前往项目的 API 密钥设置中更改权限。

配置模型访问权限和速率限制

管理项目速率限制需要管理权限。组织所有者拥有这些权限，项目所有者也可以通过管理 API 来管理项目速率限制。

1. 前往组织设置。

2. 选择项目，然后打开限额。

3. 在模型使用中选择项目可以使用的模型。

4. 根据需要为每个模型设置速率限制。

设置支出限额和提醒

你可以在组织和项目两个级别设置每月 API 支出限额。更改限额前，你需要拥有管理相应组织或项目设置的权限。

支出限额可以仅用于监控支出，而不停止请求。如果你希望在已记录的支出达到限额后，让 API 请求失败，请开启强制执行硬性限额。限额不会即时生效，因此记录的支出可能会略高于设定金额。

支出提醒会在达到阈值时通知你，但不会停止请求。

设置组织支出限额

1. 前往组织设置。

2. 打开限额，找到支出。

设置项目支出限额

1. 前往组织设置。

2. 选择项目，然后打开限额。

3. 设置每月支出限额和支出达到以下值时提醒的数值。

4. 如果你希望在已记录的支出达到限额后停止 API 流量，请开启强制执行设定的硬性限额。

你也可以在此页面更改模型使用设置。

管理支出提醒

创建项目支出限额时，默认还会创建一条在支出达到限额的 100% 时触发的提醒。选择添加提醒，可添加其他阈值的提醒。

组织所有者和项目所有者会收到项目支出提醒。你可以在提醒设置中添加其他邮件收件人。

有关最新配置步骤和限额执行方式，请参阅支出限额指南。

查看用量和账单

你可以按项目查看用量明细，也可以查看各个项目的账单并设置支出限额。

能否访问项目的用量仪表板，取决于你的组织角色和用量仪表板可见性设置。仅拥有项目所有者身份，并不意味着你有访问权限。

如果你看不到项目的用量仪表板，请检查可见性是否设为对组织所有者可见。

管理文件存储

每个项目的文件存储配额为 100 GB。如果超出配额，你可能会看到以下错误：

你已超出文件存储配额。每个组织最多可存储 100 GB 的文件。请减小文件大小或联系支持团队。

删除不再使用的文件以释放存储空间。你可以通过 API 列出已存储的文件，找出不再需要的文件。

归档项目

组织所有者和项目所有者可以通过项目页面或单个项目的设置来归档项目。出现提示时，输入项目名称进行确认。

归档是永久操作：已归档的项目无法恢复。

如需查看已归档的项目，请打开项目页面上的已归档选项卡。

项目无法删除。OpenAI 会保留项目历史记录，以便跟踪用量和账单。