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

誰可以建立專案?
只有組織擁有者可以建立專案。如需更多資訊,請參閱角色與權限。
若要在組織之間切換,請將游標停在頁面左上角的組織名稱上,然後從清單中選取組織:

對於採用整合帳單方案的組織,子組織會被個別識別。無法在子組織內建立專案。

專案如何運作?
每個組織都包含一個無法刪除的「預設專案」。您可以設定速率限制、虛擬模型權限和支出上限(截至 2024 年 11 月)。它會繼承組織的完整設定,因此您無法直接將成員或服務帳戶新增至其中。
如何建立專案?
首先,將游標停留在頁面左上角的專案名稱上,然後選取建立專案。

提供專案名稱、說明和網站,然後選取建立。

如何將使用者新增至專案?
新加入的組織成員不會自動加入「預設專案」。您可以在邀請新成員加入組織時,勾選「邀請加入預設專案」核取方塊,將他們一併加入專案;也可以等成員接受組織邀請後再加入。
透過管理員 API 邀請的使用者,須遵循 /organization/invites 端點所列的規則。
如果透過 UI 或管理員 API 邀請使用者加入專案時發生錯誤,請先確認目標專案確實存在且尚未封存,再重新傳送邀請。
組織擁有者會自動成為該組織內新建專案的擁有者。
組織和專案中有哪些不同的使用者角色,分別具備哪些權限?
組織有「擁有者」和「讀者」角色,而專案則有「擁有者」和「成員」角色。專案成員類似於組織讀者。請參閱下表,進一步了解各使用者角色所具備的權限。
| 角色 | 範圍 | 說明 |
|---|---|---|
| 擁有者 | 組織 | 可以建立/檢視所有專案、所有使用者和所有 API 金鑰。可以透過 專案頁面 監控組織內所有專案。能夠設定組織支出上限和專案支出上限。可以授予他人檢視組織用量資訊的權限。可以封存專案。 |
| 讀者 | 組織 | 可以在其專案中執行推論、使用資源並建立金鑰。可以被新增至專案。 無法建立專案和管理使用者。 |
| 擁有者 | 專案 | 可以將其他使用者新增至專案並重新命名專案,也具備成員的所有能力。能夠設定專案支出上限。可以封存專案。 |
| 成員 | 專案 | 可以在專案層級執行推論、使用資源並建立金鑰。 |
如果我不是組織擁有者,可以存取哪些內容?
不是組織擁有者的使用者,只能看到自己所屬的專案。只有組織擁有者可以查看所有專案、成員及專案層級的 API 金鑰,並可存取專案頁面。
只有專案成員(及組織擁有者)可以查看該專案中建立的微調模型、任何已建立 Assistants 的對話串,以及已新增的檔案。
專案成員可以查看該專案的所有其他成員及其角色(例如擁有者或成員)。
如何更新使用者的專案角色,或將使用者從專案中移除?
只有專案擁有者可以更新使用者的專案角色,或將使用者從專案中移除。如需更多資訊,請參閱角色與權限。
若要更新專案中的使用者,請前往組織設定,選取該專案,然後按一下成員。您可以將每位成員的角色設為成員或擁有者。您也可以選取移除,將使用者從專案中移除。
什麼是服務帳戶?它與一般使用者帳戶有何不同?
服務帳戶是為系統存取設計的擬似使用者,與個人使用者帳戶不同。只有組織與專案擁有者可以建立服務帳戶。
服務帳戶僅限於專案範圍。
將成員新增至專案
按一下 + 新增成員按鈕後,您會看到組織中角色為讀者的使用者清單。若要新增目前不在組織中的使用者,您必須先將他們加入組織(若不想讓這些使用者取得更廣泛的存取權,可不勾選「加入預設專案」核取方塊)。此清單不會包含服務帳戶。在這個步驟中,您可以將其角色設為擁有者或成員:

新增團隊成員時,您必須為其指派成員或擁有者角色。專案成員可以提出讀取或修改資料的 API 請求;專案擁有者還可以修改專案設定和支出上限,以及管理專案成員。如需更多資訊,請參閱角色與權限。
在專案層級建立的服務帳戶僅屬於該專案,無法在建立它們的專案之外使用。

命名服務帳戶
無論您是在組織層級建立服務帳戶,還是建立專案專用的服務帳戶,在建立時都可以建立由字母、數字與連字號組成的唯一服務帳戶 ID,以便輕鬆識別該服務帳戶。
儲存服務帳戶的 API 金鑰
選取建立按鈕後,系統會立即為服務帳戶建立 API 金鑰,並顯示祕密金鑰。請將這個祕密金鑰妥善保存在安全的位置。基於安全考量,之後將無法再透過您的 OpenAI 帳戶查看此金鑰。如果遺失這個祕密金鑰,您需要產生新的金鑰。

服務帳戶 API 金鑰預設具有讀取及寫入專案所有 API 資源的權限。您可以在專案的 API 金鑰設定中更新這些權限。
服務帳戶會與專案成員一併列在專案的成員設定頁面中。如要進一步瞭解如何在專案的成員設定頁面更新或移除服務帳戶的存取權,請參閱此處。
所有跨專案與組織的服務帳戶,都會與真人使用者一起顯示在組織層級成員頁面。
服務帳戶的管理方式與一般帳戶相同。在組織 -> 成員選單中,你可以移除服務帳戶或更新其角色:

如何管理組織各專案中的 API 金鑰?
您可以在各專案的設定頁面建立及管理該專案的 API 金鑰。在組織設定中選取專案,然後按一下 API 金鑰。
若要建立新的祕密金鑰,請選取 + 建立新的祕密金鑰。您也可以選取祕密金鑰旁的「編輯」圖示,以編輯其權限。

建立新的祕密金鑰或編輯現有金鑰時,您可以設定各 API 金鑰的權限。
權限分為三個層級:全部、受限和唯讀。
全部 — 為祕密金鑰設定完整權限。這是預設設定。
受限 — 可讓使用者為每個端點設定「無」、「讀取」和「寫入」權限。
例如,您可以建立一個明確不具備讀取或寫入 /v1/assistants 端點權限的 API 金鑰:

唯讀 — 為所有端點設定讀取權限。
屬於多個專案或組織的使用者,其存取權如何管理?
使用者可視需要成為任意數量專案的成員。在專案內,使用者可以產生個人 API 金鑰,其範圍與限制僅限於存取該專案及其資源。
如何設定和管理組織專案的速率限制?
只有組織擁有者可以設定和管理專案層級的速率限制。如需更多資訊,請參閱角色與權限。
在你的組織設定中,按一下要更新的專案,然後在導覽清單的專案區段中選取限制。你可以在此頁面更新模型用量。
模型用量 可讓你設定專案可使用哪些模型,並可視需要為每個模型設定速率限制。
如何設定及管理組織中各專案的支出上限?
只有組織擁有者和專案擁有者可以設定及管理專案支出上限。如需更多資訊,請參閱角色與權限。若要變更組織層級的上限,請前往組織設定,按一下上限,再向下捲動至使用量上限。

若要設定專案上限,請前往組織設定,按一下要更新的專案,然後選取上限。您可以更新每月支出上限、通知門檻和模型使用量。
設定每月支出上限,即可為專案建立非強制性的支出門檻。在指定日曆月(UTC)內,使用量超過此上限後,API 請求仍會繼續處理,不會中斷。此功能旨在透過支出上限警示協助您監控使用量,但不會強制限制支出。建立專案支出上限時,系統預設會在達到 100% 門檻時發出警示。按一下新增警示,即可針對不同門檻設定其他警示。
請注意,組織擁有者和專案擁有者一律會收到這些訊息,且此設定無法自訂。

如何為組織或專案設定支出上限?
OpenAI 現在支援在組織和專案層級設定每月 API 支出上限。支出上限可以僅監控支出而不強制執行,也可以設為硬性上限,讓支出達到上限後 API 要求失敗。如需最新設定步驟和行為,請參閱開發人員文件中的支出上限。
如何刪除或封存專案?
您可以透過新的專案清單頁面,或在個別專案的設定中封存專案。專案一旦封存便無法還原。進行封存時,系統會提示您輸入專案名稱才能繼續。
您可以在同一個專案清單頁面的「已封存」分頁中,查看所有已封存專案。

專案無法刪除。我們會保留所有專案的歷程記錄,以確保使用量與帳單追蹤的連續性。
我的組織可建立的專案數量有限制嗎?
組織預設最多可建立 2,000 個專案。
資源可以跨專案共用嗎?
專案資源(例如檔案、助理、儲存空間或執行緒)都限定於該專案範圍內,專案外的非管理員成員無法存取。此外,資源也無法在專案之間移動。
唯一的例外是,「預設專案」中的微調模型可從其他專案存取。
每個專案的檔案儲存空間配額是多少?
OpenAI 目前支援每個專案 100 GB 的檔案儲存空間配額。
若超出此配額,您會看到以下錯誤:
您已超出檔案儲存配額。組織的檔案上限為 100 GB。請縮減檔案大小或聯絡支援團隊。建議你刪除儲存在帳戶中未使用的檔案。供參考,你可以使用 API 檢視並列出檔案。
我是專案擁有者,為什麼看不到專案的使用量儀表板?
專案使用量儀表板是否可見,與使用者在專案中的角色無關。這取決於您在組織中的角色,以及 https://platform.openai.com/settings/organization/data-controls/visibility 頁面的設定。

如果您看不到使用量儀表板,這項設定很可能設為「僅組織擁有者可見」。

