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

在 API 平台中管理專案

瞭解如何建立及管理 OpenAI API 專案,包括成員、角色、服務帳戶、API 金鑰、用量限制與預算。

更新日期:15 days ago

專案旨在讓客戶能夠組織工作。組織可以管理存取權和上限、佈建服務帳戶(透過 UI),並在專案內的受限範圍中追蹤用量(例如模型、功能、執行緒、助理、微調、儲存空間等)。用量活動可以依專案細分,使用者也可以依專案檢視帳單並設定支出上限。

組織擁有者可以在專案頁面檢視其所有使用中和已封存的專案。深入了解API 平台中的使用者角色和權限

Image

誰可以建立專案?

只有組織擁有者可以建立專案。如需詳細資訊,請參閱角色與權限

若要切換組織,請將游標移至頁面左上方的組織名稱,然後從清單中選取組織:

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

採用整合帳單方案的組織,其子組織會分別標示。無法在子組織內建立專案。

Image

專案如何運作?

每個組織都包含一個無法刪除的「預設專案」。您可以設定速率限制、虛擬模型權限及支出上限(截至 2024 年 11 月)。此專案會繼承組織的完整設定,因此您無法直接將成員或服務帳戶加入其中。

如何建立專案?

首先,將游標移至頁面左側的專案名稱,然後選取建立專案

API platform project menu with Create project highlighted under Default project

輸入專案名稱、說明和網站,然後選取建立

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

如何將使用者加入專案?

新加入的組織成員不會自動加入「預設專案」。您可以在邀請新成員加入組織時,勾選「邀請加入預設專案」,或等成員接受組織邀請後,再邀請他們加入專案。

透過管理員 API 邀請的使用者,適用 /organization/invites 端點所列的規則。

若透過使用者介面或管理員 API 邀請使用者加入專案時發生錯誤,請先確認目標專案存在且未封存,再重新傳送邀請。

組織擁有者會自動成為組織內新建專案的擁有者。

組織和專案中有哪些使用者角色?各角色具備哪些權限?

組織設有「擁有者」和「讀者」角色,專案則設有「擁有者」和「成員」角色。專案成員相當於組織讀者。各使用者角色所具備的權限,請參閱下表中的詳細說明。

角色範圍說明
擁有者組織可以建立及查看所有專案、所有使用者和所有 API 金鑰。可以透過

專案頁面
監控組織內的所有專案。可以設定組織和專案的支出上限。可以授予組織中的其他人查看用量資訊的權限。可以封存專案。
讀者組織可以在所屬專案中執行推論、使用資源及建立金鑰。可以加入專案。
無法建立專案及管理使用者。
擁有者專案可以將其他使用者加入專案及重新命名專案,並具備成員的所有權限。可以設定專案支出上限。可以封存專案。
成員專案可以在專案層級執行推論、使用資源及建立金鑰。

如果我不是組織擁有者,可以存取哪些內容?

不是組織擁有者的使用者只能看到自己所屬的專案。只有組織擁有者可以查看所有專案,以及專案層級的所有成員和 API 金鑰,並可存取專案頁面

  • 只有專案成員(和組織擁有者)可以查看該專案內建立的微調模型、任何已建立助理的執行緒,以及已新增的檔案。

  • 專案成員可以查看該專案的所有其他成員及其角色(例如擁有者或成員)。

如何更新使用者的專案角色,或將使用者移出專案?

只有專案擁有者可以更新使用者的專案角色,或將使用者移出專案。如需詳細資訊,請參閱角色與權限

若要更新專案中的使用者,請前往組織設定,選取專案,再按一下成員。您可以將每位成員的角色設為成員擁有者。您也可以選取移除,將使用者移出專案。

什麼是服務帳戶?它與一般使用者帳戶有何不同?

服務帳戶是專為系統存取而設計的虛擬使用者,與個人使用者帳戶不同。只有組織和專案擁有者可以建立服務帳戶。

服務帳戶僅限於專案範圍。

將成員加入專案

按一下 + 新增成員按鈕後,您會看到組織中角色為讀者的使用者清單。若要新增目前不在組織中的使用者,您必須先將他們加入組織(若不想授予這些使用者更廣泛的存取權,可不要勾選「加入預設專案」)。此清單不會包含服務帳戶。在此步驟中,您可以將其角色設為擁有者成員

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

新增團隊成員時,您必須為其指派成員擁有者角色。專案成員可以提出讀取或修改資料的 API 請求;專案擁有者還可修改專案設定和支出上限,以及管理專案成員。如需詳細資訊,請參閱角色與權限

如何為專案建立服務帳戶

首先,從導覽列中的下拉式選單選取要建立服務帳戶的專案:

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

接著,前往組織設定 -> 專案 -> 成員 -> 按一下 + 服務帳戶

在專案層級建立的服務帳戶僅屬於該專案,無法在建立它們的專案之外使用。

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 金鑰

若要建立新的祕密金鑰,請選取+ 建立新的祕密金鑰。您也可以選取祕密金鑰旁的「編輯」圖示來編輯其權限。

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

如何設定組織或專案的支出上限?

OpenAI 現已支援組織和專案層級的每月 API 支出上限。支出上限可以只監控支出而不強制執行,也可以設為硬性上限,讓支出達到上限後的 API 請求失敗。如需最新的設定步驟和運作方式,請參閱開發人員文件中的支出上限

如何刪除或封存專案?

您可以在新版專案清單頁面或個別專案的設定中封存專案。專案一經封存便無法復原。進行封存時,系統會要求您輸入專案名稱才能繼續。

您可以在同一個專案清單頁面的「已封存」分頁中,查看所有已封存專案。

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

若您看不到用量儀表板,此設定可能設為「組織擁有者可見」。

這篇文章有幫助嗎?