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

# ACU 限额

> 通过 V3 API 和 Web 应用管理组织级和用户级月度限额，以控制 Devin ACU 用量。

Enterprise 管理员可设置 Agent Compute Unit (ACU，算力单元) 限额，以控制整个 Enterprise 的用量。限额分为两类，适用方式不同：

|          | [组织级限额](/zh/admin/billing/org-acu-limits)                                                     | [用户级限额](/zh/admin/billing/user-acu-limits)             |
| -------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| **上限**   | 归属于单个组织的总用量                                                                                   | 单个用户的用量                                                |
| **适用方式** | 按产品类别拆分：**Local Agent** 限额 (Devin Desktop、Windsurf JetBrains、Devin CLI) 和 **Devin** 限额 (云端会话) | 本地和云端用量合并计算，共用一个账户级上限                                  |
| **管理方式** | 按组织设置限额                                                                                       | **层级**：除非设置了个人覆盖值，否则每位用户都会通过显式分配、IdP 组映射或默认层级继承相应层级的限额 |

两类限额独立执行：只要用户限额或相关组织限额任一达到上限，请求就会被阻止。所有限额都会在每个**月度周期**开始时自动重置。

* 有关按产品类别设置的组织级预算，请参阅[组织级 ACU 限额](/zh/admin/billing/org-acu-limits)。
* 有关层级、IdP 组映射、用户级覆盖设置、提高限额请求和有效限额，请参阅[用户级 ACU 限额](/zh/admin/billing/user-acu-limits)。
* 有关已弃用的用户级和默认用户限额端点，请参阅[旧版用户 ACU 限额端点](/zh/admin/billing/legacy-user-acu-limits)。

<div id="manage-limits-with-the-v3-api">
  ## 通过 V3 API 管理限额
</div>

所有请求都使用企业 **服务用户令牌**进行身份验证。读取限额设置需要 **ViewAccountConsumption** 账户权限；更新或删除限额设置需要 **ManageBilling** 账户权限 (读取[提高限额请求](/zh/admin/billing/user-acu-limits#limit-increase-request-endpoints)也需要该权限) 。使用 `https://api.devin.ai` 作为基础 URL。有关身份验证和服务用户的相关说明，请参阅 [V3 API 概览](/zh/api-reference/v3/overview)。

<div id="patch-semantics">
  ### PATCH 语义
</div>

对于 `PATCH` 端点：

* 省略的字段保持不变。
* 字段设为 `null` 时会被清空。
* 字段设为某个值时会被创建或更新。

<div id="frequently-asked-questions">
  ## 常见问题
</div>

<AccordionGroup>
  <Accordion title="组织级限额和用户级限额有什么区别？">
    组织级限额会限制归属于某个组织的总用量，并按产品类别划分 (Local Agent 和 Devin 云端会话) 。用户级限额会限制单个用户在账户级范围内的本地和云端合并用量，并通过层级管理。两者彼此独立执行。
  </Accordion>

  <Accordion title="如果我不设置任何限额，会怎样？">
    如果未配置任何限额，这些限额控制就不会对用量施加约束，但仍需遵循你的企业套餐和计费条款。
  </Accordion>

  <Accordion title="我可以将限额设为零吗？">
    可以。将 `cycle_acu_limit` 设置为 `0` 会阻止该作用域内的用量，直到限额被提高或移除。
  </Accordion>

  <Accordion title="限额多久重置一次？">
    所有限额都会根据你的计费周期按月重置。
  </Accordion>

  <Accordion title="如何查找用户和组织 ID？">
    可以通过 `GET /v3/enterprise/members/users` 获取用户 ID，通过 `GET /v3/enterprise/organizations` 获取组织 ID，或者在 Devin Web 应用的企业设置中查找。
  </Accordion>

  <Accordion title="我可以在 Web 应用中设置限额吗？">
    可以，两类限额都可以设置。用户级限额在企业设置的[用量政策](/zh/enterprise/features/usage-policies)下管理，管理员可在此创建和编辑层级、将用户分配到层级、设置永久或临时的用户级覆盖设置，并在 **ACU 请求** 下查看提高限额请求。组织级 Devin 限额可在[企业计费](/zh/admin/billing/enterprise#setting-organization-acu-limits)下管理。组织级 Local Agent 限额目前通过 V3 API 管理。Enterprise Admin 还可以在企业设置的 **Consumption** 下，按产品或用户查看当前周期的 ACU 用量。
  </Accordion>
</AccordionGroup>