---
title: "Quota strategies"
description: "Define model-opaque quota units, reset intervals, integer multipliers, and safe output bounds for a plan."
---

> Documentation Index
> Fetch the complete documentation index at: https://nexus.microvoid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quota strategies

## Outcome

你可以配置和解释 QuotaStrategy，验证整数公式，并知道为什么同一 Strategy 对 Provider 定义的不同模型使用相同套餐倍率。

## Strategy fields

| Field                      | Meaning                               |
| -------------------------- | ------------------------------------- |
| `resetInterval`            | `MONTH` 或 `YEAR` 的额度周期。        |
| `quotaUnits`               | 每个新 QuotaPeriod 的 Granted Units。 |
| `inputMultiplierPpm`       | 非缓存 Input Token 的整数 PPM 倍率。  |
| `cachedInputMultiplierPpm` | Cached Input Token 的整数 PPM 倍率。  |
| `outputMultiplierPpm`      | Output Token 的整数 PPM 倍率。        |
| `maxOutputTokens`          | Reserve 时使用的安全输出上限。        |

`1,000,000 ppm` 等于 `1.0x`。倍率不使用 Float，所有中间计算使用至少 64 位整数。

## Unit formula

```text
uncached_input_tokens = max(input_tokens - cached_input_tokens, 0)

weighted_token_ppm =
    uncached_input_tokens × input_multiplier_ppm
  + cached_input_tokens   × cached_input_multiplier_ppm
  + output_tokens         × output_multiplier_ppm

quota_units = ceil(weighted_token_ppm / 1,000,000)
```

舍入只发生在一次 Invocation 的最终合计处。

## Model names stay opaque

QuotaStrategy 不按 `model` 查找规则。客户端传入的原始模型名由所选 ProviderConnection 接受或拒绝；相同 Token Usage 和相同倍率快照始终得到相同 Units。

Quota Unit 表达非货币的 AI 使用权。它不是法币、可提现 Credit、Provider Cost 或支付余额。Workspace 如需限制高成本模型，应使用受限的上游 Provider Secret，等待后续独立策略，或拆分 Workspace。

## Publish before binding

草稿 Strategy 可以校验和编辑；发布后配置不可变。Plan 通过带生效区间的 Binding 使用已发布版本，QuotaPeriod 在创建时复制策略快照。

## Next steps

- [Workspace plans](/docs/control-plans-and-quota/workspace-plans)
- [Quota periods](/docs/control-plans-and-quota/quota-periods)

Source: https://nexus.microvoid.io/docs/control-plans-and-quota/quota-strategies/index.mdx