OpenAI
此頁面由機器翻譯。查看原始英文文章

在 API 平台中管理專案

更新日期:7 days 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 個專案。

資源可以跨專案共用嗎?

專案資源(例如檔案、助理、儲存空間或執行緒)都限定於該專案範圍內,專案外的非管理員成員無法存取。此外,資源也無法在專案之間移動。

唯一的例外是,「預設專案」中的微調模型可從其他專案存取。

每個專案的檔案儲存配額是多少?

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

如果你無法看到使用量儀表板,此設定可能設為「僅組織擁有者可見」。

這篇文章有幫助嗎?