# AI 额度

AI 额度按设备管理文字对话、语音识别和语音合成的预算，便于核算和管理各设备的 AI 使用成本。启用按设备限制后，各设备使用独立余额，避免高频使用的设备消耗其他设备的预算；管理员也可按业务需要为指定设备补充额度。

## 配置设备额度

1. 打开**设置 → AI 额度**。
2. 选择**结算货币**，支持人民币 `CNY` 和美元 `USD`。
3. 填写**每设备额度**，打开**按设备限制**。
4. 点击**保存**，确认页面显示保存成功。

**每设备额度**是每台设备的基础预算。例如选择 `CNY` 并填写 `50`，表示每台设备各有 50 元预算。新设备从该预算开始使用；修改预算时，已有设备的额度余额按新旧预算的差额调整，已用金额和充值 / 人工余额保留。

例如，设备已用 12 元、人工余额 5 元，基础预算为 50 元时，可用总额为 43 元。将基础预算改为 60 元后，可用总额增加到 53 元。该预算持续使用；为单台设备补充额度时，调整该设备的人工余额。提高**每设备额度**会同时影响所有设备。

AI 额度限制默认关闭。创建额度账户后，平台会锁定结算货币；请在启用限制并开始交互或人工调整余额前选好币种。关闭**按设备限制**后，系统继续统计用量，但新交互不扣除设备余额；重新启用时不追扣关闭期间的用量。

![默认 AI 额度配置，按设备限制处于关闭状态](../images/docs/platform/ai-credits/zh/01-budget.png)

## 设置计费规则

展开**计费规则**，填写基础单价：

| 项目 | 计价单位 |
| --- | --- |
| 输入、输出、缓存读取、缓存写入 | 每百万 Token |
| 语音识别 | 每分钟音频 |
| 语音合成 | 每千字符 |
| 未知用量最低扣费 | 用量不完整或未知时，每次调用的最低基础费用；已知部分费用更高时采用较高金额 |

单价使用所选结算货币，填写非负金额，最多支持 6 位小数。每次实际模型调用分别计费：用量乘对应单价，再乘该模型的倍率。例如输入单价为 1 元 / 百万 Token，输出单价为 4 元 / 百万 Token，1,000 输入 Token 加 500 输出 Token 的基础费用为 0.003 元；2 倍时扣费 0.006 元。

这些单价由管理员配置，与模型服务商的实际账单、[监控费用估算](./monitoring.md#核对费用和累计用量)分别管理。未知或不完整的用量可能按最低扣费计入，因此监控估算和设备已用金额可能不同。

为不同模型设置价格时，在**模型倍率**中点击**添加模型**，填写**提供商**、**模型**和**倍率**。提供商和模型标识必须与实际调用一致，按[监控用量记录](./monitoring.md#查看-ai-用量)核对；未匹配的模型使用 1 倍，填写 `2` 表示按基础费用的 2 倍扣费。允许使用 `0` 单价或倍率。

一轮语音交互可能同时使用 LLM、语音识别和语音合成，各模型分别按自己的倍率扣费，再合计到设备余额。删除某条倍率时，点击该行的删除按钮。完成编辑后点击**保存**；新的规则供之后开始的交互使用，正在进行的交互继续使用开始时的规则。

![AI 额度计费规则](../images/docs/platform/ai-credits/zh/02-pricing.png)

## 查看设备余额

在**设备余额**区域选择目标设备，查看：

| 字段 | 含义 |
| --- | --- |
| 每设备额度 | 当前统一设置的基础预算 |
| 可用总额 | 额度余额与充值 / 人工余额之和，决定能否开始新的交互 |
| 额度余额 | 基础预算扣除消耗后剩余的部分 |
| 充值 / 人工余额 | 人工增加或扣减的余额 |
| 已用 | 累计扣除的金额 |

系统先扣额度余额，再扣充值 / 人工余额。图表显示预算使用情况；在表格中核对具体金额及可用总额是否为负数。调整前核对设备智能体和设备 ID。

## 调整指定设备的余额

1. 在**设备余额**中选中设备。
2. 填写**调整金额**：正数增加余额，负数扣减余额。例如 `10` 增加 10 个货币单位，`-2` 扣减 2 个货币单位。金额不能为 `0`，最多支持 6 位小数。
3. 填写**原因**，例如“补充试用额度”或“人工修正”。
4. 点击**确认调整**，在弹窗中核对设备、金额和原因，再确认提交。

调整单独提交并立即计入充值 / 人工余额，无需再点击**保存**。成功后页面更新余额；扣减会降低可用总额，提交前核对调整后的余额。

## 余额不足时

开启限制后，可用总额小于或等于 0 的设备无法开始下一轮 AI 交互。已获准开始的一轮可以完成，余额可能因此显示为负数。

遇到额度不足提示时，先查看该设备的余额，再增加人工余额或提高每设备额度。余额为负数时，补充金额需覆盖超出的部分，并使可用总额大于 0，之后重新发起请求。失败、取消或重试产生的实际 AI 用量也会计费。

补充设备余额后仍无法发起请求时，按提示检查[License 授权](./license.md#授权控制什么)的请求启动频率和有效期，以及模型、语音服务商的额度或余额。

## 常见问题

| 现象 | 处理方式 |
| --- | --- |
| 保存按钮不可用 | 确认修改过设置，金额非负且最多 6 位小数，并补全新增倍率的提供商和模型；不需要的空行可删除。 |
| 无法更改结算货币 | 已有额度账户时币种会锁定；按现有币种管理预算和余额。 |
| 确认调整按钮不可用 | 选择设备，填写非零调整金额和原因。金额最多支持 6 位小数。 |
| 余额暂时无法读取或调整失败 | 核对设备选择，按页面提示重试；持续失败时请管理员检查服务状态，并在确认成功后核对余额。 |