企業帳號

企業帳號讓整個團隊從同一個餘額消費。企業主的帳號餘額就是企業餘額，每位成員用自己的金鑰呼叫 API，所有費用都從這份共用餘額扣除。端點、請求內容和用戶端設定與個人帳號完全相同；本頁只說明呼叫方屬於企業時有哪些不同。

成員發出請求

acme-…

使用自己的金鑰，以企業前綴開頭。

檢查額度

這次請求的預估費用必須放得進成員剩餘的額度。

記到企業帳上

依企業主帳號的價格、分組和訂閱計費。

記在成員名下

企業主和管理員可以依成員、模型、金鑰和日期查看。

成員手上沒有自己的錢，額度只限制他能從企業餘額花多少。

角色

角色	帳號	能做什麼
企業主	提交申請的帳號	餘額就是企業餘額。管理所有人、儲值、查看全企業用量。不能被停用。
管理員	透過邀請建立	在額度內呼叫 API，邀請和管理成員、儲值、查看全企業用量。
成員	透過邀請建立	在額度內使用 API、圖像與影片工作台和 Castaly。不能儲值。

管理員和成員都是透過郵件邀請新建的帳號，受邀信箱不能已在平台註冊，所以既有的個人帳號無法加入企業。這些帳號不參與平台的獎勵活動。

企業主和管理員可以隨時停用帳號，該帳號的登入工作階段和金鑰立即失效。帳號只能停用、不能刪除，用量紀錄會一直保留。

API 金鑰

企業金鑰以企業的金鑰前綴開頭，例如 acme- 後面接 48 位英文字母和數字。前綴在申請時填寫，審核通過時確定，之後不能修改。前綴為 2 到 16 位小寫英文字母和數字，以字母開頭。

同一把金鑰把前綴換成 sk- 也能用。如果某個用戶端只接受 sk- 開頭的金鑰，就用這種寫法：兩種寫法是同一把金鑰，權限和計費完全相同。

Text

Authorization: Bearer acme-<48 characters>
Authorization: Bearer sk-<48 characters>

金鑰帶的前綴若不屬於它所在的企業，會被當成無效金鑰並回傳 401。

企業主在申請通過前建立的金鑰也會顯示為企業前綴，原本的 sk- 寫法繼續有效，既有的串接不需要修改。

管理員和成員在控制台只能建立和看到自己的金鑰。企業主和管理員可以在企業控制台依成員管理全企業的金鑰。

成員額度

每位管理員和成員都有一個額度。錢不會撥給他們，額度只是他們最多能從企業餘額花多少。

模式	規則
不限	只受企業餘額限制。
一次性	一筆固定額度，不會自動重設。
按月	每月 1 日 00:00（UTC）從零重新計算。

只調整上限時，已用金額保留；切換到其他模式時從零開始計算。

請求開始前，閘道會依預估費用從成員剩餘額度中預留，放不下就直接拒絕。請求結束後依實際費用結算。結算不會拒絕，所以最後一筆請求可能讓成員略超上限，下一筆才會被拒絕。請求失敗或退款時，金額也會退回成員額度。

成員用到額度的 80% 和用完時，都會收到郵件提醒。

計費、分組與速率限制

在閘道看來，成員的請求就是企業主帳號的請求。除額度外，其他一切都依企業主帳號生效：

• 費用從企業餘額扣除，扣法與企業主自己呼叫時相同，企業主的訂閱同樣可用。
• 價格、分組以及金鑰能呼叫的模型，都以企業主帳號為準。
• 速率限制按整個企業計算。企業主和所有成員共用一份限額，所以 429 可能是團隊裡其他人的請求觸發的。

企業餘額用完後，企業內所有人的請求都會回傳 403 和 insufficient_user_quota，與個人帳號餘額不足時相同。企業主和管理員可以在企業控制台儲值，成員不能儲值。設定餘額提醒線後，餘額跌破時企業主和管理員會收到郵件。

錯誤

情況	狀態	如何辨識
金鑰帶的是其他企業的前綴	401	依無效金鑰處理
成員額度已用完	403	code 為 enterprise_member_budget_exhausted
成員被停用，或企業被平台暫停	403	message 說明帳號已停用
企業餘額已用完	403	code 為 insufficient_user_quota
整個企業觸發速率限制	429	與個人帳號相同

401 和 403 這幾種情況重試不會恢復。額度錯誤要等管理員調高上限，按月額度也可以等到下個月；餘額錯誤在儲值後恢復。

非同步任務

用成員金鑰提交的任務，只能用該成員自己的金鑰查詢。用其他成員的金鑰查詢，結果與任務不存在相同。企業主的金鑰可以查詢企業內任何人提交的任務。

用量與日誌

• 每筆請求日誌都會記錄是哪位成員發出的。
• 管理員和成員在自己的控制台裡只能看到自己的請求。
• 企業主的日誌頁能看到全企業的請求，並多一欄「成員」。
• 企業主和管理員可以在企業控制台依成員、模型、金鑰和日期統計消費，並開啟任一成員的逐筆請求。
• 能查多久取決於企業主帳號的日誌保留期，請見資料保留。企業主縮短保留期，企業報表也隨之縮短。

開通企業帳號

在 Modelflare 控制台提交申請，填寫企業名稱、想要的金鑰前綴和聯絡信箱。審核通過後，你的帳號成為企業主，帳號餘額成為企業餘額，接著在企業控制台邀請團隊成員。完整方案請見企業方案。