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

# 设置使用配置

> 用于 Enterprise 账单管理，可设置或清除每个用户的附加积分使用上限，并可将其应用到整个团队、群组或单个用户。

<div id="overview">
  ## 概览
</div>

为你的组织中每位用户设置或清除附加额度的使用上限。上限始终按用户单独生效。当你指定团队或群组的作用域时，上限会分别应用到该团队或群组中的每个用户——不会为整个团队或群组设置共享上限。

<div id="request">
  ## 请求
</div>

<ParamField body="service_key" type="string" required>
  具有 "Billing Write" 权限的服务密钥
</ParamField>

<div id="credit-cap-configuration-choose-one">
  ### 附加额度上限配置（二选一）
</div>

<ParamField body="clear_add_on_credit_cap" type="boolean">
  设为 `true` 可清除现有的附加额度上限
</ParamField>

<ParamField body="set_add_on_credit_cap" type="integer">
  设置新的附加额度上限（整数）
</ParamField>

<Info>
  你必须提供 `clear_add_on_credit_cap` 或 `set_add_on_credit_cap` 之一，且不可同时提供。
</Info>

<div id="scope-configuration-choose-one">
  ### 作用域配置（任选其一）
</div>

<ParamField body="team_level" type="boolean">
  将其设为 `true`，即可在团队中对每位用户应用逐用户额度上限
</ParamField>

<ParamField body="group_id" type="string">
  提供组 ID，可在该组中对每位用户应用逐用户额度上限
</ParamField>

<ParamField body="user_email" type="string">
  提供用户的电子邮件地址，可将该配置应用于指定的用户
</ParamField>

<Info>
  必须提供 `team_level`、`group_id` 或 `user_email` 之一以定义作用域。
</Info>

<div id="example-request-set-per-user-credit-cap-for-all-users-on-team">
  ### 示例请求 - 为团队中所有用户设置单用户信用额度上限
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 10000,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-set-per-user-credit-cap-for-all-users-in-a-group">
  ### 示例请求 - 为群组内所有用户设置个人信用额度上限
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 5000,
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-set-credit-cap-for-user">
  ### 示例请求：为用户设置用量上限
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "set_add_on_credit_cap": 1000,
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="example-request-clear-credit-cap">
  ### 示例请求 - 清除额度上限
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "clear_add_on_credit_cap": true,
  "team_level": true
}' \
https://server.codeium.com/api/v1/UsageConfig
```

<div id="response">
  ## 响应
</div>

响应体为空。`200` 状态码表示操作成功。

<div id="error-responses">
  ## 错误响应
</div>

常见错误情形：

* 服务密钥无效或权限不足
* 同时提供了 `clear_add_on_credit_cap` 和 `set_add_on_credit_cap`
* 既未提供 `clear_add_on_credit_cap` 也未提供 `set_add_on_credit_cap`
* 提供了多个 scope 参数
* 未提供 scope 参数
* 组 ID 或用户邮箱无效
* 触发速率限制