OpenAI
页面内容为机器翻译。查看英文原文

在 API 平台中管理项目

更新于:6 hours ago

项目旨在为客户提供组织其工作的能力。组织可以管理访问权限和限制、预配服务账号(通过 UI),并在项目内按受限范围跟踪用量(例如模型、功能、线程、助手、微调、存储等)。用量活动可以按项目细分,用户可以按项目查看计费并设置预算。

组织所有者可以在项目页面中查看其所有活跃和已归档项目。详细了解 API 平台中的用户角色和权限

Image

谁可以创建项目?

只有组织所有者可以创建项目。如需了解更多信息,请参阅角色和权限

要在组织之间切换,请将鼠标悬停在页面左上角的组织名称上,然后从列表中选择组织:

Projects page with the organization switcher open, listing Personal and Staging organizations

对于使用合并计费方案的组织,子组织会单独标识。无法在子组织内创建项目。

Image

项目如何运作?

每个组织都包含一个“默认项目”,且无法删除。您可以配置速率限制、虚拟模型权限和支出预算(截至 2024 年 11 月)。它会继承组织的完整配置,因此您无法直接向其中添加成员或服务账户。

如何创建项目?

首先,将鼠标悬停在页面左侧角落的项目名称上,然后选择 Create project

API platform project menu with Create project highlighted under Default project

为您的项目提供名称、描述和网站,然后选择 Create

Create a new project dialog in the API platform with fields for project name, use case, and business website

如何向项目添加用户?

新添加的组织成员不会自动加入“默认项目”。可以在邀请新成员加入组织时(通过勾选“邀请到默认项目”复选框),或在成员接受组织邀请后,邀请他们加入项目。

通过 Admin API 邀请的用户将遵循/organization/invites 端点所述规则。

如果你通过 UI 或 Admin API 邀请用户加入项目时遇到错误,请先确认目标项目存在且未归档,然后再重新发送邀请。

组织所有者会自动作为所有者添加到该组织内新创建的项目中。

组织和项目中的不同用户角色是什么,它们分别包含哪些权限?

组织拥有“所有者”和“读取者”角色,而项目拥有“所有者”和“成员”角色。项目成员类似于组织读取者。请参阅下表,了解每个用户角色所具备权限的更详细说明。

角色范围说明
所有者组织可以创建/查看所有项目、所有用户和所有 API 密钥。可以通过

项目页面
监控组织内的所有项目。能够设置组织预算和项目预算。可以授予他人查看组织中用量信息的权限。可以归档项目。
读取者组织可以在其项目中执行推理、使用资源并创建密钥。可以被添加到项目。
无法创建项目和管理用户。
所有者项目可以向项目添加其他用户并重命名项目,同时具备成员的所有能力。能够设置项目预算。可以归档该项目。
成员项目可以在项目级别执行推理、使用资源并创建密钥。

如果我不是组织中的所有者,我可以访问什么?

不是组织所有者的用户只能看到自己所属的项目。只有组织所有者可以看到项目级别的所有项目、成员和 API 密钥,并且可以访问项目页面

  • 只有项目成员(以及组织所有者)可以看到该项目内创建的微调模型、任何已创建助手的线程,或任何已添加的文件。

  • 项目成员可以看到该项目的所有其他成员及其角色(即所有者或成员)。

如何更新用户的项目角色或将用户从项目中移除?

只有项目所有者可以更新用户的项目角色或将用户从项目中移除。如需了解更多信息,请参阅角色和权限

要更新项目中的用户,请前往你的组织设置,选择该项目,然后点击成员。你可以将每位成员的角色设置为成员所有者。你也可以选择移除,将该用户从项目中移除。

什么是服务账户,它与普通用户账户有何不同?

服务账户是一种为系统访问设计的伪用户,不同于个人用户账户。只有组织所有者和项目所有者可以创建服务账户。

服务账户仅限于项目范围。

向项目添加成员

如果你点击 + Add member 按钮,将看到组织中角色为 Reader 的用户列表。如果你想添加当前不在组织内的用户,需要先将其添加到组织(如果不想授予这些用户更广泛的访问权限,可以不勾选“添加到默认项目”复选框)。此列表不会包含服务账号。在此步骤中,你可以选择他们的角色为 OwnerMember

Project members with Add team members dialog assigning a user the Member role

添加团队成员时,必须为其分配 Member Owner 角色。项目成员可以发起读取或修改数据的 API 请求,而项目所有者还可以修改项目设置和项目预算,并管理项目成员。如需了解更多信息,请参阅角色和权限

如何为项目创建服务账号

首先,从导航栏中的下拉菜单选择要为其创建服务账号的项目:

API platform project switcher open with options to create a project or manage projects

然后,前往你的组织设置 -> 项目 -> 成员 -> 点击 + Service account

在项目级别创建的服务账户仅对该项目唯一,不能在其创建所在项目之外使用。

Project Members page with Create a service account dialog after selecting the Service account option

为服务账户命名

无论您是在组织级别创建服务账户,还是创建项目专用的服务账户,在创建服务账户时,您都可以创建一个由字母、数字和连字符组成的唯一服务账户 ID,以便轻松识别该服务账户。

保存服务账号 API 密钥

选择创建按钮后,系统会立即为服务账号创建一个 API 密钥,并显示该密钥。请将此密钥保存在安全可靠的位置。出于安全原因,你无法再通过你的 OpenAI 账号查看它。如果丢失此密钥,则需要生成一个新的密钥。

Members page with Save your key modal after creating a service account

服务账号 API 密钥权限默认可读取和写入该项目的所有 API 资源。可以在项目的 API 密钥设置中更新这些权限。

服务账号会与项目成员一起列在项目的成员设置页面中。请参阅此处,了解有关在项目成员设置页面中更新或移除服务账号访问权限的更多信息。

项目和组织中的所有服务账号都会与人类用户一起显示在组织级成员页面上。

服务账号的管理方式与普通账号相同。在组织 -> 成员菜单中,你可以移除服务账号或更新其角色:

OpenAI API Members settings with a service account role menu open for Reader or Owner

如何管理我组织项目中的 API 密钥?

你可以在每个项目的设置页面为该项目创建和管理 API 密钥。在你的组织设置中,选择该项目,然后点击 API 密钥

要创建新的密钥,请选择 + Create new secret key。你也可以选择密钥旁边的编辑图标来编辑其权限。

API keys page for a project with the Create new secret key button highlighted

你可以在创建新密钥时或通过编辑现有密钥,为每个 API 密钥设置权限。

可用的权限级别有三种:全部、受限和只读。

  • 全部 — 为该密钥设置完整权限。这是默认设置。

  • 受限 — 允许用户为每个端点设置无、读取和写入权限。

    • 例如,你创建了一个 API 密钥,专门不具备对 /v1/assistants 端点的读取或写入权限:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • 只读 — 为所有端点设置读取权限。

对于属于多个项目或组织的用户,访问权限如何管理?

用户可以根据需要成为任意数量项目的成员。在项目内,用户可以生成一个个人 API 密钥,该密钥的作用域和访问权限仅限于该项目及其资源。

如何为我组织的项目设置和管理速率限制?

只有组织所有者可以设置和管理项目级速率限制。如需了解更多信息,请参阅角色和权限

在你的组织设置中,点击要更新的项目,然后在导航列表的“项目”部分选择限制。你可以在此页面更新模型使用情况

模型使用情况 允许你配置项目可以使用哪些模型,并可根据需要为每个模型设置速率限制

如何为我组织的项目设置和管理预算?

只有组织所有者和项目所有者可以设置和管理项目预算。如需了解更多信息,请参阅角色和权限。要更改组织级别的限制,请在你的组织设置中点击限制,然后向下滚动到用量限制

Project Limits page with organization budget controls, usage alerts, and model rate limits table

要设置项目限制,请在你的组织设置中点击要更新的项目,然后选择限制。你可以更新每月预算通知阈值模型使用情况

设置每月预算可让你为项目设定软性支出阈值。当某个日历月(UTC)内的用量超过此限制时,API 请求仍会继续处理,不会中断。此功能旨在通过预算提醒帮助你监控用量,但不会对支出强制设置硬性上限。创建项目预算时,默认会在 100% 阈值处创建一条提醒。可以点击添加提醒,在不同阈值设置其他预算。

请注意,组织所有者和项目所有者将始终收到这些消息,且无法自定义。

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

如何删除或归档项目?

可以通过新的项目列表页面,或在单个项目的设置中归档项目。项目一旦归档便无法恢复。执行归档时,系统会提示你输入项目名称以继续。

你可以在同一项目列表页面的“已归档”选项卡中查看所有已归档项目的列表。

API platform Projects page with the Archived tab selected to view archived projects

无法删除项目;我们会保留所有项目的历史记录,以确保用量和计费跟踪的连续性。

我的组织中可拥有的项目数量有限制吗?

默认情况下,组织最多可以创建 2,000 个项目。

资源可以跨项目共享吗?

项目资源(如文件、assistants、存储或线程)仅限于项目范围内,项目外的非管理员成员无法访问。此外,资源也无法在项目之间移动。

唯一的例外是,“默认项目”中的微调模型可从其他项目访问。

每个项目的文件存储配额是多少?

OpenAI 目前支持每个项目最多 100 GB 文件的存储配额。

如果超出此配额,您将看到以下错误:

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

我们建议你删除账号中存储的未使用文件。作为参考,你可以使用 API 查看和列出文件

我是项目所有者,为什么看不到项目的用量仪表板?

项目用量仪表板的可见性与用户在项目中的角色无关。它取决于你在组织内的角色以及https://platform.openai.com/settings/organization/data-controls/visibility 中的设置。

Project setting for Usage dashboard visibility with Visible to organization owners selected

如果你无法看到用量仪表板,此设置很可能设为“仅组织所有者可见”。

这篇文章对你有帮助吗?