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

在 API 平台管理專案

更新日期:3 days ago

項目旨在讓客戶能夠整理自己的工作。組織可以管理存取權和上限、佈建服務帳戶(透過使用者介面),並在項目內受限範圍中追蹤使用量(例如模型、功能、對話串、助理、微調、儲存空間等)。使用活動可按項目細分,使用者亦可按項目查看帳單和設定支出上限。

組織擁有者可以在項目頁面查看其所有有效和已封存項目。進一步了解 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 金鑰,並可存取專案頁面

  • 只有專案成員(和組織擁有者)可以看到在該專案內建立的微調模型、任何已建立 Assistants 的執行緒,或任何已加入的檔案。

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

如何更新用戶的專案角色,或從專案中移除用戶?

只有專案擁有者可以更新用戶的專案角色,或從專案中移除用戶。如需更多資訊,請參閱角色和權限

若要更新專案中的用戶,請前往你的組織設定,選擇專案,然後按一下成員。你可以選擇將每位成員的角色設為成員擁有者。你亦可選擇移除,將用戶從專案中移除。

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

服務帳戶是為系統存取而設的擬似用戶,與個別用戶帳戶不同。只有機構及專案擁有者可以建立服務帳戶。

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

將成員加入項目

如果你按一下 + 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

然後,前往你的組織設定 -> Project -> Members -> 按一下 + 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 金鑰設定中更新。

服務帳戶會與專案成員一同列在你專案的成員設定頁面。請參閱此處,了解如何在你專案的成員設定頁面更新或移除服務帳戶的存取權。

橫跨專案和組織的所有服務帳戶都會與真人用戶一同顯示在組織層級成員頁面

服務帳戶會像一般帳戶一樣管理。你可以從 Organization -> Members menu 移除服務帳戶或更新角色:

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 部分選擇限制。你可以在此頁面更新你的模型用量

模型用量 可讓你設定專案可使用哪些模型,並可按需要為每個模型設定速率限制

如何為我組織的項目設定和管理支出上限?

只有組織擁有者和項目擁有者可以設定和管理項目支出上限。請參閱角色與權限了解更多資訊。如要變更組織層級的上限,請在你的組織設定中按一下上限,然後向下捲動至使用量上限

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 個專案。

資源可以跨專案共用嗎?

專案資源(例如檔案、assistants、儲存空間或 threads)均限定於該專案範圍內,專案外的非管理成員無法存取。此外,資源亦不能在專案之間移動。

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

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

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

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

這篇文章對你有幫助嗎?