團隊和多個專案共用一個帳號：按成員、專案、環境分 Key 管理
一個帳號下不分成員帳號，團隊協作靠 API Key 來分：每個成員、專案和環境各用一把 Key，分別設額度上限、過期時間、模型限制、IP 白名單和分組；用量在操作日誌和資料看板裡按 Key 拆開看，可以匯出給財務。帳號由負責人開兩步驗證、看安全日誌，指令碼用權限受限的個人訪問令牌。
一個土土金 API 帳號下不分成員帳號，團隊協作靠 API Key（控制台裡叫「令牌」）來分：一個成員、一個專案、一個環境各用一把 Key，每把 Key 單獨設定額度上限、過期時間、模型限制、IP 白名單和分組。每次呼叫都記在 Key 的名下，用量在操作日誌和資料看板裡能按 Key 拆開看，匯出 CSV 就能交給財務。帳號本身只由負責人登入，開兩步驗證，定期看安全日誌；需要自動查餘額、查用量的指令碼，用權限受限的個人訪問令牌，不共享登入密碼。
怎麼分 Key
按「誰在用、用在哪個專案、哪個環境」拆，一把 Key 只對應一種用途：
| 維度 | 名稱示例 | 建議設定 |
|---|---|---|
| 環境 | 客服機器人-生產、客服機器人-測試 | 生產 Key 設 IP 白名單；測試 Key 的額度上限設低一些 |
| 專案或產品線 | 知識庫-生產、營銷文案-生產 | 每個專案一個額度上限，模型限制裡只放這個專案用到的模型 |
| 成員開發除錯 | 張三-開發 | 額度上限小，設過期時間，專案結束就停用 |
| 外包、試點 | 外包-官網改版 | 過期時間加額度上限，到期自動失效 |
名稱會出現在操作日誌和匯出的 CSV 裡，寫清專案和環境，月底拆帳時一眼能看出歸屬。新增令牌時可以一次建立多把（最多 100 把），從第 2 把起名稱自動加隨機字尾，給新團隊批次發 Key 很方便。
每把 Key 能管什麼
在控制台「令牌」頁新建或編輯 Key 時設定，儲存後立即生效：
| 設定 | 作用 | 超出限制時 |
|---|---|---|
| 額度上限 | 這把 Key 累計最多能花多少錢，也可以選不限額度 | 返回 401，其他 Key 不受影響 |
| 過期時間 | 到期後這把 Key 失效；有 1 小時到 1 年的快捷選項，也可以指定日期 | 返回 401 |
| 模型限制 | 只允許呼叫選中的模型 | 返回 403 |
| IP 白名單 | 只接受指定 IP 或網段發來的請求，每行一個 | 返回 403 |
| 分組 | 一個分組，或按優先順序的多個分組，決定線路和價格 | 分組都沒有這個模型時返回 503 |
| 允許查詢餘額 | 在「高階」裡，允許只憑這把 Key 讀取帳戶餘額，方便監控指令碼 | — |
幾點要注意：
- 額度上限是累計的，不會按月重置。按月控制預算時，每月初把上限改成「已用金額 + 本月預算」。
- 所有 Key 共用帳戶餘額。餘額不足時所有 Key 都會返回 403，錯誤碼
insufficient_user_quota，見錯誤碼與重試。 - 關鍵業務可以給 Key 配多個分組，主線路出問題時自動切換，做法見大模型 API 高可用。
按 Key 看用量
- 「操作日誌」：每條記錄有時間、模型、分組、令牌、tokens 和花費。按令牌名稱篩選，開啟「顯示統計」，「篩選時段消耗」就是這把 Key 在所選時間內的消費合計；非同步任務失敗退回的錢另記為「退款」記錄。
- 「資料看板」：「令牌與分組」一欄按令牌、分組和模型彙總消費，適合看各專案的佔比。看板按小時彙總，僅供參考，金額以操作日誌為準。
- 匯出：操作日誌右上角的「匯出」生成 CSV，交給財務。按專案拆帳、每月核對的完整步驟見成本分攤與對帳。
給指令碼用個人訪問令牌
要讓指令碼定時查餘額、拉用量，或者批次管理 API Key，在「帳號設定」的「訪問令牌」裡建立個人訪問令牌，不要把登入密碼交給指令碼：
- 只勾選指令碼需要的權限，比如「檢視用量日誌、統計與安全日誌」「檢視餘額與充值記錄」。
- 選有效期：7 天、30 天、90 天、365 天，或者永不過期。
- 建立時要驗證身份，令牌只顯示這一次，馬上存進金鑰管理系統。
- 指令碼請求控制台介面時，在請求頭裡帶
Authorization: Bearer <令牌>。
個人訪問令牌和 API Key 是兩回事：API Key 用來呼叫模型；訪問令牌用來呼叫控制台介面，按權限範圍授權。不用的令牌及時刪除。
餘額提醒
在「帳號設定」的「額度提醒」裡開啟餘額不足提醒，餘額從閾值以上降到閾值以下時，通過郵件或 Webhook 通知一次。Webhook 可以填簽名金鑰，方便你的服務校驗來源。團隊共用一個錢包，最好把提醒發到值班郵箱或群機器人，而不是某個人的郵箱。
保護負責人的帳號
控制台能建立、檢視和刪除所有 Key，負責人的帳號要單獨保護好：
- 只讓負責人登入控制台，不共享帳號密碼。
- 在「帳號設定」的「安全」裡開啟兩步驗證：登入和敏感操作時，除了密碼還要輸入驗證器 App 裡的動態碼。備用碼存在安全的地方。
- 同一頁的「登入會話」列出當前登入著這個帳號的瀏覽器，發現陌生裝置就登出它並修改密碼。
- 「安全日誌」記錄登入、安全設定的變更，以及 API Key 的建立、修改、啟用或停用、刪除和檢視完整 Key，帶時間、結果、IP 和裝置，定期看一眼。
人員和專案變動時
| 情況 | 怎麼做 |
|---|---|
| 成員離職 | 停用他的開發 Key；他接觸過的生產 Key 新建一把替換上線，再停用舊的 |
| 外包或試點結束 | Key 到期自動失效；提前結束就手動停用 |
| 專案下線 | 停用這個專案的所有 Key，月結後再決定是否刪除 |
| 懷疑 Key 洩露 | 立刻停用，新建一把替換，再到操作日誌核對異常呼叫，見 API Key 安全最佳實踐 |
停用比刪除好：停用的 Key 隨時能重新啟用；刪除之後，資料看板的「令牌與分組」裡只顯示「已刪除的令牌」和編號，按 Key 看用量就不方便了。
常見問題
能給團隊成員開子帳號嗎？
不能。一個帳號下不分成員帳號，團隊按 API Key 來分權限和用量：每個成員、專案、環境各用一把 Key，控制台只由負責人登入，不共享帳號密碼。
Key 的額度上限會按月重置嗎？
不會，額度上限是累計的。想按月控制預算，每月初把這把 Key 的額度上限改成「已用金額 + 本月預算」。
各把 Key 的錢是分開的嗎？
不是。所有 Key 共用帳戶餘額，額度上限只限制單把 Key 最多能花多少。帳戶餘額不足時，所有 Key 都會呼叫失敗。
財務怎麼拿到用量資料？
在控制台「操作日誌」按時間和令牌名稱篩選後匯出 CSV；需要定期自動拉取的，給指令碼建立只讀權限的個人訪問令牌。
成員離職或外包結束怎麼處理？
停用他用過的 Key。如果他接觸過生產環境的 Key，新建一把替換上線，再停用舊的。停用比刪除好：停用的 Key 能重新啟用，資料看板裡也還能按原來的名字看用量。