> ## Documentation Index
> Fetch the complete documentation index at: https://cloud-docs.orbi.build/llms.txt
> Use this file to discover all available pages before exploring further.

# 额度与限制

> 免费额度和每月 token 额度是多少，用完会发生什么?

有两个额度：订阅前的 3 次合并交付免费额度，订阅后每月 3 亿 tokens 的模型用量。

两者到顶时的行为一致：新派发的工作会被暂停并在 Issue 上留下说明，而**正在执行的交付永远不会被打断**。

## 免费额度

前 **3 次合并的交付免费**，不用绑卡，不用订阅。

名额在你给 Issue 打上 `ai-ready` 时占用，如果那次交付最终没有合并，名额会**退回** —— 落到 `ai-blocked` 的 Issue，或者你自己关掉而没有合并的 Issue，都会把名额还回来。所以这个额度的口径是「3 次**合并**的交付」，而不是「3 次尝试」。

计数按 Issue 且幂等：给同一张 Issue 重新打标签不会再消耗一个名额。退回之后重新交付同一张 Issue，用的是它自己还回来的那个名额。

### 额度用完时

你下一次打上 `ai-ready` 的 Issue，标签会被摘掉，并收到一条评论说明免费额度已用完，附订阅链接。

<Frame caption="免费额度已用完的租户状态页">
  <img src="https://mintcdn.com/orbi-cloud/Ya1dzVX1ins06kld/images/zh/status-free-exhausted.png?fit=max&auto=format&n=Ya1dzVX1ins06kld&q=85&s=e4c08b22a3557457d86551b9cf2dcfaf" alt="免费额度已用完的租户状态页" width="1920" height="5564" data-path="images/zh/status-free-exhausted.png" />
</Frame>

**怎么恢复：** 订阅，然后**重新给这张 Issue 打上 `ai-ready` 标签**。标签不会自动恢复。额度用完那一刻已经在途的交付会正常跑完。

## 每月 token 额度

订阅包含**每个自然月（UTC）3 亿（300,000,000）tokens**。没有按 token 的超额计费 —— 额度用完时新交付暂停，直到下个月开始。

用量统计包括输入 tokens、输出 tokens 和缓存读取 tokens。重新交付同一张 Issue 会累加：每次交付都是一次独立的运行。

粗略参考，3 亿 tokens 大约够 **85 到 400 次合并的交付**，取决于任务大小。这个区间的前提是你的 provider 支持 prompt caching。

### 看你的用量

状态页的**本月用量**卡片显示已用 tokens、额度上限、剩余量和百分比进度条。

旁边是**本月缓存命中率**，这个数比看上去重要。缓存未命中的 token 单价大约是命中的 **50 倍**，所以命中率低于 90% 会明显更快烧掉额度。如果你的命中率偏低，先搞清楚原因，再下「额度不够用」的结论。

每条工作记录也有自己的用量明细 —— 输入、输出、缓存 tokens，运行时长，模型请求数，以及中断后继续了几次。没有上报用量的工作显示 `—`。

### 额度用完时

行为和免费额度一致：新派发 Issue 的 `ai-ready` 标签会被摘掉，评论里会写明你的实际用量和上限。在途的交付不受影响。

**怎么恢复：** 等下一个自然月，或者[配置你自己的模型 key](/zh/model-configuration) —— BYOK 的用量只被观测，永远不会被暂停。两种方式都需要你**自己重新打上 `ai-ready`**。

<Note>
  如果 Orbi 的用量采集链路异常，额度检查会**失败即拒**而不是靠猜 —— 新派发会暂停，并留下一条说明用量采集暂时异常的评论。这是有意设计的：它不会基于一个自己都不信任的数字去花钱。这个状态会自行恢复。
</Note>

## 永远不会被打断的东西

两个额度都不会停掉正在进行的工作。两个守卫只对**刚刚**打上 `ai-ready`、且不带任何其他 `ai-*` 标签的 Issue 生效 —— 所以处在 `ai-in-progress`、`ai-pr-opened` 或 `ai-fix-needed` 的交付，无论如何都会跑完。

平台升级和部署也有同样的性质：它们不会重启一个已经在执行的交付。

## 单仓库限制

Orbi Cloud 同一时间只在**一个仓库**里工作。你随时可以换 —— 见[连接仓库](/zh/connect-repository) —— 但不能在有交付在途时换。

## 小结

| 限制        | 数值            | 到顶时                     | 怎么恢复                           |
| --------- | ------------- | ----------------------- | ------------------------------ |
| 免费额度      | 3 次合并的交付      | 摘掉 `ai-ready`，评论附订阅链接   | 订阅，重新打 `ai-ready`              |
| 每月 tokens | 每个自然月（UTC）3 亿 | 摘掉 `ai-ready`，评论写明用量与上限 | 等下个月，或改用 BYOK；都要重新打 `ai-ready` |
| 生效仓库数     | 1             | 连接新的会替换旧的               | —                              |
| 认领间隔      | 最长 5 分钟       | —                       | —                              |