跳到正文
土土金API

課題組怎麼用一個帳號管理大模型 API 和經費:每個學生、每個課題一把 Key

課題組由導師或實驗室管理員開一個帳號、統一充值,給每個學生和課題各建一把 API Key,分別設額度上限、過期時間和模型限制;每月在操作日誌按 Key 匯出用量對帳,憑訂單號申請發票報銷;學生畢業停用 Key,統計指令碼用個人訪問令牌。

課題組用大模型 API,最省事的做法是一個帳號管到底:導師或實驗室管理員註冊帳號、負責充值,給每個學生、每個課題各建一把 API Key(控制台裡叫「令牌」),按預算設額度上限,按學期或專案週期設過期時間,用模型限制只放行需要的模型。每次呼叫都記在發起請求的 Key 名下,月底在「操作日誌」按 Key 匯出用量,就能按學生和課題拆帳;報銷用的發票憑充值訂單號申請。學生畢業或離組時停用他的 Key;需要定時統計用量的指令碼,用權限受限的個人訪問令牌,不用登入密碼。

帳號由誰來開

  • 導師或實驗室管理員(下文統稱負責人)註冊帳號,負責充值、建 Key 和對帳。一個帳號下不分成員帳號,學生不登入控制台,也不拿帳號密碼。
  • 負責人在「帳號設定」的「安全」裡開啟兩步驗證,定期看「安全日誌」:Key 的建立、修改、啟用或停用、刪除和檢視完整金鑰都有記錄。
  • 所有 Key 共用帳戶餘額。1 元 = 1 元額度,按實際用量扣減,沒有月費,也沒有最低消費承諾。

怎麼給學生和課題分 Key

一把 Key 只對應一個人或一個用途,名稱寫清歸屬,月底看操作日誌就知道錢花在了哪裡:

用途名稱示例建議設定
學生個人的實驗和開發張三-畢業論文額度上限按每月預算設,過期時間設到學期末
課題或專案課題A-模型評測額度上限等於這個課題分給 API 的預算;模型限制只放行課題用到的模型
實驗室共用的服務實驗室文獻庫-伺服器IP 白名單隻填實驗室伺服器的地址,由專人維護
訪問學者、合作者、短期實習合作-李四過期時間設到合作結束,額度上限設小一些
課程或工作坊工作坊-11月新增令牌時一次建立多把(最多 100 把),從第 2 把起名稱自動加隨機字尾;過期時間設到活動結束

每把 Key 設什麼

在控制台「令牌」頁新增或編輯 Key 時設定,儲存後立即生效:

  • 額度上限:這把 Key 累計最多能花多少錢,花到上限就停止工作,其他 Key 不受影響。額度上限是累計的,不會按月重置;按月控制時,每月初把上限改成「已用金額 + 本月預算」。
  • 過期時間:有 1 小時到 1 年的快捷選項,也可以指定日期。按學期、專案或合作期設定,到期自動失效。
  • 模型限制:開啟「只允許呼叫指定模型」後,這把 Key 只能呼叫勾選的模型。給學生的 Key 只放行實驗需要的模型,程式碼裡模型名寫錯也不會調到單價高的旗艦模型。
  • 分組:決定線路來源和價格。實驗結果要寫進論文、需要說清模型來源的,選標著「官方轉發」的分組,選法見如何選分組。
  • IP 白名單:只接受指定 IP 或網段發來的請求,適合固定在實驗室伺服器上執行的 Key。

超出各項限制時返回什麼錯誤、怎麼按環境分 Key,見團隊和多個專案共用一個帳號。

充值與餘額提醒

  • 線上充值:在控制台「充值」頁選擇支付方式和金額,支付方式以控制台顯示為準,支付成功後餘額自動到帳。
  • 兌換碼:需要走學校採購流程或對公轉帳的,聯絡客服線下付款,客服提供兌換碼,在「充值」頁兌換成餘額。批次採購見企業服務。
  • 餘額提醒:在「帳號設定」的「額度提醒」裡開啟餘額不足提醒,餘額從閾值以上降到閾值以下時,通過郵件或 Webhook 通知一次。全組共用一個餘額,提醒最好發到課題組的公共郵箱,不要只發給某一個人。

每月對帳

  1. 在「操作日誌」選上個月的整月,日誌類型選「消費」,點「匯出」下載 CSV;再把類型換成「退款」匯出一次。
  2. 按「令牌」列彙總「花費(¥)」、減去退款,就是每個學生、每個課題的花費;幾把 Key 屬於同一筆經費的,再加在一起。
  3. 想快速看一把 Key 花了多少:在「令牌」頁這把 Key 的操作選單裡點「檢視用量」,或者在操作日誌裡按令牌名稱篩選,開啟「顯示統計」看「篩選時段消耗」。
  4. 「資料看板」的「令牌與分組」按令牌、分組和模型彙總消費,適合看各課題的佔比;看板僅供參考,金額以操作日誌為準。
  5. 發票、充值記錄和匯出的 CSV 放在一起歸檔,報銷和結題時能對上。

匯出的注意事項(單次最多 20,000 條、按瀏覽器時區計算日期、CSV 裡的分組列)和彙總指令碼,見成本分攤與對帳。

發票與報銷

國內發票和海外 Invoice 都可以開:加客服微信 JsnonoChat,傳送訂單號即可申請。訂單號在「充值」頁的「全部記錄」裡複製。報銷需要哪些材料、費用列在哪個科目,以學校財務的要求為準。

學生畢業或離開課題組

情況怎麼做
學生畢業或離組停用他的 Key;他接觸過的共用 Key 新建一把替換上線,再停用舊的
合作或實習結束Key 到期自動失效;提前結束就手動停用
課題結題停用這個課題的 Key,對完帳再決定是否刪除
懷疑 Key 洩露,例如被提交到公開的程式碼倉庫立刻停用,新建一把替換,再到操作日誌核對異常呼叫,見 API Key 安全最佳實踐

停用比刪除好:停用的 Key 隨時能重新啟用;刪除之後,資料看板的「令牌與分組」裡只顯示「已刪除的令牌」和編號,回看某個學生的用量就不方便了。

給統計指令碼用個人訪問令牌

想每月自動拉一份用量、或者定時檢查餘額,在「帳號設定」的「訪問令牌」裡建立個人訪問令牌,不要把登入密碼寫進指令碼:

  1. 只勾選指令碼需要的權限,例如「檢視用量日誌、統計與安全日誌」和「檢視餘額與充值記錄」。
  2. 有效期選 7 天、30 天、90 天、365 天或永不過期。
  3. 建立時要驗證身份,令牌只顯示這一次,馬上存到安全的地方。
  4. 指令碼請求控制台介面時,在請求頭裡帶 Authorization: Bearer <令牌>。

個人訪問令牌和 API Key 是兩回事:學生拿到的是 API Key,用來呼叫模型;訪問令牌用來呼叫控制台介面,只放在負責人自己管理的腳本里。

學生怎麼用自己的 Key

  • Key 只放在伺服器或自己電腦的環境變數裡,不寫進程式碼,不提交到程式碼倉庫,也不發到群聊裡。
  • 介面地址是 https://www.tutujin.com/v1,相容 OpenAI 的 SDK 改 base_url 和 api_key 就能用,見快速開始。
  • 實驗記錄裡寫清模型 ID、參數和呼叫日期,做法見科研與高校。

一學期的操作清單

時間做什麼
學期初給新學生和新課題建 Key,設額度上限、過期時間和模型限制;確認餘額提醒已開啟
每月初匯出上月的消費和退款記錄對帳;按月控制的 Key 把額度上限改成「已用金額 + 本月預算」;申請發票
學期末停用畢業和離組學生的 Key,確認到期的 Key 已失效,視情況更換共用的 Key

課題組常見的用法,見科研與高校、大模型評測與基準測試、社科文本分析與定性編碼和文獻閱讀與綜述輔助。

常見問題

能給每個學生開一個子帳號嗎?

不能。一個帳號下不分成員帳號,課題組按 API Key 來分:每個學生、每個課題各用一把 Key,控制台只由導師或實驗室管理員登入,帳號密碼不交給學生。

怎麼防止某個學生或課題把經費用超?

給這把 Key 設額度上限,花到上限後這把 Key 停止工作,不影響其他 Key。額度上限是累計的,不會按月重置;按月控制時,每月初把上限改成「已用金額 + 本月預算」。再用模型限制只放行需要的模型,避免誤調單價高的模型。

學校要求對公轉帳,能充值嗎?

能。聯絡客服線下付款(例如對公轉帳),客服會提供兌換碼,在控制台「充值」頁兌換成餘額。線上充值的支付方式以控制台顯示為準。

可以開發票報銷嗎?

可以。國內發票和海外 Invoice 都能開,加客服微信 JsnonoChat 並提供訂單號即可申請。訂單號在控制台「充值」頁的「全部記錄」裡複製。

學生畢業或離開課題組,他的 Key 怎麼處理?

停用他的 Key;他用過實驗室伺服器上共用的 Key 的,新建一把替換上去,再停用舊的。停用比刪除好:停用的 Key 能重新啟用,資料看板裡也還按原來的名字顯示用量。

幾個課題的經費怎麼分開算?

每個課題單獨建 Key,名稱裡寫上課題名或編號。月底在操作日誌匯出消費和退款記錄,按「令牌」列彙總、減去退款,就是各課題的花費。所有 Key 共用帳戶餘額,Key 只決定花費記在誰名下。