ChatGPTAPI额度

成本与用量

给初次接 OpenAI API 的开发者讲清额度体系怎么运作:分几个口袋、去哪查、什么时候会被卡。

第一次接 OpenAI API,最容易懵的不是写代码,而是搞不清「额度」到底指哪个东西:是账户里的预充值余额,还是组织级的月度上限,还是免费赠送的那点体验金?三者混在一起,就会出现「明明后台还有钱却报额度不足」的情况。这篇按你实际会遇到的顺序,把额度体系的几个部分拆开讲,并给出查额度的固定路径,具体数字一律让你去站内页面看当时的。

第一次接 OpenAI API,最容易懵的不是怎么写请求,而是搞不清「额度」这个词到底指哪个东西。是账户里预充值的那笔余额,还是组织级的月度上限,还是新账号赠送的那点体验金?这三者混在一起,就会出现「后台明明还有钱,接口却报额度不足」的情况。这篇按你实际接入会遇到的顺序,把额度体系拆开讲,并给出查额度的固定路径。

先给一个总原则:报错时不要急着充值,先判断是哪一层触发的。OpenAI 的额度更像三道闸门串在一起,钱只是其中一道。搞清顺序,排查会快很多。具体涉及金额、单价、赠送规则的数字,站内都有页面在跟,直接去看当时的,不要凭记忆。

先分清「额度」这个词在 OpenAI 后台指的三种东西

新手最容易把这三个概念当成一个。它们分别在后台的不同位置,触发的报错也不一样。先建立这个心智模型,后面查账和排查都会顺很多。

余额(Credit)
你实际充进去、按用量扣的那笔钱,扣完就停,没有缓冲
用量上限(Usage Limit)
组织或项目级的月度封顶,是闸门不是钱包,设低了会出现「有余额却调不动」
免费赠送额度
新账号有时限、有过期规则,走完就只剩付费余额,别把它当长期预算
  • 报错先定位:是钱花完了,还是被闸门拦住了,还是赠送额度到期了
  • 三者不叠加:赠送额度消耗顺位和付费余额不同,具体规则到站内模型资料页核对当时的说明
  • 别默认「充值就等于解锁」:上限设得过低时,充值也调不动接口
  • 判断口径:先看哪一层触发,再决定是充值、调上限还是换 key

额度到底在哪看:三条固定路径

后台页面不少,但你排查额度只需要盯住三个地方,顺序固定下来能省很多来回点。建议把这几页在浏览器里固定成一组书签,报错时按顺序扫一遍。

  1. 第一步:看账单页的余额和本月已用确认钱还剩多少、这个月已经花了多少。如果余额见底,答案基本就在这里,别再往下猜。
  2. 第二步:看用量页的拆分按模型、按项目看 token 消耗,找出是哪块在吃额度。经常是这个页面的数字解释了账单页的异常。
  3. 第三步:看限额设置页确认组织和项目级的月度上限。余额还在但调不动,九成是这里设低了,或者项目分流没配好。
页面看什么典型用途
账单页余额、本月已用确认钱还剩多少
用量页按模型/项目拆的 token 消耗定位钱花在哪
限额设置页月度上限、项目分流判断是不是闸门卡住

这三页的具体数字会变,站内会把关键数值做成可对照的页面。要估算成本时,到 价格追踪页(/price-watch) 看当时的单价,再用 token 数换算,比凭印象估准得多。

什么时候额度会卡住你:几种典型触发顺序

额度卡人不是单一原因,而是按一定顺序触发的。理解这个顺序,你就能在报错时快速缩小范围,而不是乱试。

  • 余额耗尽:请求直接失败,不会先给你缓冲,这种情况只能充值
  • 月度上限打满:余额还在但被组织闸门拦住,要等下个结算周期或手动调高上限
  • 密钥或项目被单独限流:同一账号下换个 key 可能就通了,说明问题在项目配置而非账户余额
  • 赠送额度过期:体验金到期后自动失效,用量会转去扣付费余额,表现为「突然开始花钱了」

还有一种情况要排除:如果是延迟高、请求超时、连接被重置,多半是网络或并发问题,跟额度无关。先去 测速工具(/tools/speed-test) 跑一下,别把网络问题当成额度问题来回折腾。

避免「充了钱还是不够用」的几个动作

余额和上限都理顺之后,剩下的是习惯问题。下面这几个动作不难,但能把「月底突然发现额度被跑飞」的概率压下去。

  1. 按项目拆 key给每个项目或环境单独的 key,让用量页能按项目归因。一个 key 打天下,出问题时你根本看不出是谁在花。
  2. 给非核心项目设低上限测试环境、脚本类项目单独设一个偏低的月度上限,防跑飞。核心业务再单独放宽。
  3. 按月导出用量对账把用量页的数据和实际账单对一次,看差额来自什么。是某次批量任务,还是某个模型被误用,一目了然。
  4. 不确定单价就先换算不熟悉的模型先用站内工具把 token 数换成金额再估预算,别拍脑袋定上限。
现象先查什么大概率原因
报余额不足账单页余额钱确实花完了
有余额但调不动限额设置页月度上限设低或项目分流问题
换个 key 就通项目/密钥配置单项目被限流
开始扣费变快赠送额度过期体验金走完转付费余额

这套动作覆盖的是常见情况,不适用于所有场景。如果你的调用量本身波动很大,或者用的是组织下的共享额度,判断逻辑要按团队实际配置来调整,别照搬单账号的排查顺序。

最后提醒一点:所有涉及金额、单价、赠送规则的数字都别记死,平台会调,站内页面也会跟着更新。养成「用时再查」的习惯,比背数字靠谱。

下一步把余额、用量、上限这三页的排查顺序存下来,再去站内价格追踪页核对当时的单价,估一遍你的月度预算。

常见问题

OpenAI API 报「额度不足」,但我看账户里还有钱,是怎么回事?

大概率是组织或项目的月度用量上限被打满了,那道闸门跟余额是两回事。先去限额设置页看月度上限,再看账单页确认余额没扣光。如果是免费赠送额度用完,也会出现类似提示,得单独确认一下赠送额度的有效期。

怎么快速知道自己这个月 API 花了多少、还剩多少?

账单页看余额和本月已用,用量页看按模型和项目拆的 token 消耗,两个加一起就能还原。具体金额和单价会变,去 /official-api/providers/openai 核对当期数字,别用记忆里的价。

新账号的免费额度是不是能一直用?

不是,免费赠送额度通常带有效期,过期就没了,也不一定能覆盖所有模型。想确认自己还剩下什么,去 /ai-dict 和站内免费额度类页面看当期规则。免费额度只适合试通链路,正式跑之前还是按预估用量准备预算。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。