火山方舟coding plan额度分5小时滚动、自然周周一零点、订阅日每月零点三重独立刷新机制,任一耗尽即限制对应请求,控制台与响应头可实时查看各维度余额及重置时间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

一、5小时滚动周期刷新规则
该规则以您首次触发请求的时间为起点,每满5小时自动重置一次可用额度。这意味着刷新时间点因人而异,不统一固定于整点。
1、假设您在4月10日10:17首次调用API,则下一个5小时刷新点为15:17;
2、若此后在14:50再次发起请求,仍处于上一周期内,不会提前触发刷新;
3、若您在15:17之后的任意时刻发起请求,系统将启用全新5小时额度窗口;
4、每次新窗口开启后,计时器重新从该次请求时刻开始累计5小时。
二、周限额重置规则
周限额独立于5小时周期,采用自然周对齐方式,在每周一的零点整(00:00:00)强制清零并重置为全额。
1、无论您上周是否用完额度,周一00:00:00一到,周限额立即恢复初始值;
2、该重置不受个人使用行为影响,所有用户均在同一时刻同步刷新;
3、若周一00:00:00恰好处于某次5小时周期中段,两个额度机制并行运行,互不干扰;
4、例如:周日23:59发出的请求计入旧周额度,而周一00:00:01的请求即归属新周额度。
三、月限额重置规则
月限额依据您的订阅起始日确定,于每个“订阅月”的首日00:00:00重置,而非公历每月1日。
1、若您于4月15日完成首订,则首个订阅月为4月15日至5月14日,重置时间为5月15日00:00:00;
2、若您于3月3日订阅,则每月重置时间为3月3日、4月3日、5月3日等对应日期的00:00:00;
3、该日期一旦锁定,终身不变,与自然月无关;
4、重置时刻精确到秒,系统在00:00:00整完成额度归零与补足操作。
四、多周期共存与叠加逻辑
三项额度独立计算、互不抵扣,任一额度耗尽均会导致对应维度的请求受限,但其余维度仍可正常使用。
1、当5小时额度用尽但周/月额度仍有余量时,仅限制高频短时调用,不影响日常中低频使用;
2、若周限额归零而5小时与月额度充足,系统将阻止所有超出本周配额的请求;
3、三者中任意一项触发限制,均会返回明确错误码与提示文本,标明具体受限维度;
4、控制台「额度使用详情」页面按三类周期分别展示实时消耗值与剩余值,支持毫秒级刷新。
五、额度查看与验证方法
开发者可通过官方控制台或API响应头实时确认当前各维度额度状态,避免误判为服务异常。
1、登录火山方舟管理控制台,进入「Coding Plan」→「额度使用情况」页面;
2、在API响应头中查找 X-RateLimit-Remaining-5H、X-RateLimit-Remaining-Week 与 X-RateLimit-Remaining-Month 字段;
3、响应头中同时包含对应重置时间戳字段,如 X-RateLimit-Reset-5H,单位为Unix毫秒时间;
4、调用 GET /v1/quotas 接口可批量获取全部额度维度的精确数值与重置时间。











