跳到正文
土土金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 只决定花费记在谁名下。