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

本文介绍如何在 API Playground 页面查看终端用户的用量数据、用量明细、管理设备配额以及查看设备流水详情。以便开发者清晰掌握终端用户资源使用状况，从而实现精细化管理。
:::tip 说明
* **套餐限制**：企业旗舰版、原企业版。
* **角色限制**：企业超级管理员或管理员。
* **数据更新**：设备管理页面的数据将在次日更新，暂不支持查看当天的使用数据。 
:::
## 设备概览 {#dae8291b}
通过**设备概览**页面，你可以快速了解设备的日活数、对话次数、语音转文字用量、文字转语音用量、实时音视频用量等关键指标，从而分析设备使用情况并优化资源配置。
1. 企业超级管理员或管理员登录[扣子编程](https://code.coze.cn/home)。
2. 在左下角单击个人头像，选择企业> **团队与企业管理**。
   ![Image=267x259](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/eb420c9c12cf4559ab2ea46162f4ca72~tplv-goo7wpa0wc-image.image)




3. 在左侧导航栏中选择**设备管理**页签，在**设备概览**页面，在顶部选择统计维度和时间段，支持查看近 7 天、近 30 天和近 60 天的数据。
   统计维度默认为按设备维度进行统计，你也可以选择按自定义维度。如果选择按自定义维度，需要先在 OAuth JWT 授权的 `Payload` 中设置 `custom_consumer` 参数，用于设置用量统计的自定义维度，具体请参见 [OAuth JWT 授权（开发者）](/developer_guides/oauth_jwt)。
   ![Image=600x717](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/609caf02ef064285afb2cf064bd06280~tplv-goo7wpa0wc-image.image)
   <!-- @cols-width: 210,606 -->
   | | | \
   |**图表名称** |**说明** |
   |---|---|
   | | | \
   |日活数 |在指定时间段内，与设备内的智能体进行过对话的设备数。 |
   | | | \
   |对话次数 |统计所有设备在指定时间段内的有效对话次数，以及每台设备的日均用量。 |\
   | |每台设备的日均用量 = 时间段内的总对话次数 / 时间段内的天数 / 日活数。 |\
   | |有效对话次数是指用户询问后，设备中的智能体进行了回应，即计为一次有效对话。 |
   | | | \
   |ASR 语音转文字用量（分钟） |所有设备在指定时间段内，每天进行语音转文字操作的总时长，以及每台设备的日均用量。 |\
   | |每台设备的日均用量 = 时间段内的总 ASR 语音转文字总用量 / 时间段内的天数 / 日活数。 |
   | | | \
   |TTS 文字转语音用量（字符数） |所有设备在指定时间段内，每天将文字转换为语音的字符数量，以及每台设备的日均用量。 |\
   | |每台设备的日均用量 = 时间段内的 TTS 文字转语音总用量 / 时间段内的天数 / 日活数。 |
   | | | \
   |RTC 实时音频用量（分钟） |所有设备在指定时间段内每天的音频通话时长，以及每台设备的日均用量。 |\
   | |每台设备的日均用量 = 时间段内的 RTC 实时音频总用量 / 时间段内的天数 / 日活数。 |
   | | | \
   |RTC 实时视频用量（分钟） |所有设备在指定时间段内每天的视频频通话时长，以及每台设备的日均用量。 |\
   | |每台设备的日均用量 = 时间段内的 RTC 实时视频总用量 / 时间段内的天数 / 日活数。 |


## 查询用量明细 {#31d16b4e}
在**团队与企业管理**的**设备管理**页签中，单击**用量明细及管控**页签，可以查看各个设备最近 1 天或最近 7 天的用量明细。
![Image=600x160](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ac18918cfc96433691d98edf3eda11db~tplv-goo7wpa0wc-image.image)
明细列表中的参数说明如下：
<!-- @cols-width: 157,674 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|设备 ID |用于唯一标识每台设备。 |
| | | \
|累计对话次数 |设备自使用以来的总对话次数。 |
| | | \
|当期对话次数 |设备在选定时间段内的对话次数。 |
| | | \
|累计账单金额 |设备自使用以来的总费用。 |
| | | \
|当期账单金额 |设备在选定时间段内的费用。 |

## 管理设备配额 {#d616a2be}
你可以为每台设备设置免费使用额度，以便用户在初始阶段免费体验设备功能，同时避免资源的过度使用。通过合理的额度配置，既能满足用户的试用需求，又能有效控制资源消耗。
:::tip 说明
* 未配置限额时，默认支持无限使用。
* 任何一个配额耗尽时，设备将无法继续使用。
:::
在**用量明细及管控**页面，单击右上角的**全局配额（设备维度）**，可以配置设备的配额，对你所在火山引擎主账号下的所有设备生效，支持按积分维度或语音通话时长维度设置配额。
![Image=400x428](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/65a7a5f77f6648409ca9fd5fbc76e4f4~tplv-goo7wpa0wc-image.image)
配置示例：
例如你可以设置每个设备累计额度为 5000 积分，每天可用 500 积分。当设备 A 在某一天的使用积分达到 500 上限后，设备 A 当天将无法继续使用，需等到次日才能恢复使用，当设备 A 的累计使用积分达到 5000 上限后，设备 A 将无法继续使用。
参数说明：
<!-- @cols-width: 148,169,520 -->
| | | | \
|**维度** |**参数** |**说明** |
|---|---|---|
| | | | \
|积分配额 |积分累计额度 |设置每个设备累计可用的积分。 |\
| | |:::tip 说明 |\
| | |未增购 **AI 智能通话许可**的企业，仅支持积分配额。购买 AI 智能通话许可的详细步骤请参见[购买 AI 智能通话许可](/coze_pro/asr_tts_fee#f007a15b)。 |\
| | |::: |
|^^| | | \
| |积分周期额度 |设置每个设备在累计周期内可用的积分。 |
| | | | \
|语音通话时长配额（系统音色） |语音通话时长累计额度 |当智能体使用系统音色时，设置每个设备累计可用的语音通话时长。 |
|^^| | | \
| |语音通话时长周期额度 |当智能体使用系统音色时，设置每个设备在累计周期内可用的语音通话时长。 |
| | | | \
|语音通话时长配额（复刻音色） |语音通话时长累计额度 |当智能体使用复刻音色时，设置每个设备累计可用的语音通话时长。 |
|^^| | | \
| |语音通话时长周期额度 |当智能体使用复刻音色时，设置每个设备在累计周期内可用的语音通话时长。 |

不同场景的计费和配额说明如下表所示。
<!-- @cols-width: 131,139,177,165,247 -->
| | | | | | \
|**增购 AI 智能通话许可（系统音色）** |**增购 AI 智能通话许可（复刻音色）** |**智能体使用的音色** |**默认计费规则** |**配置配额** |
|---|---|---|---|---|
| | | | | | \
|**未购买** |**未购买** |系统音色/复刻音色 |按积分计费 |仅支持积分配额 |
| | | | | | \
|**已购买** |**未购买** |系统音色 |按系统音色计费 |推荐配置： |\
| | | | | |\
| | | | |* 积分配额 |\
| | | | |* 语音通话时长配额（系统音色） |
|^^|^^| | |^^| \
| | |复刻音色 |按积分计费 | |
| | | | | | \
|**未购买** |**已购买** |系统音色 |按复刻音色计费 |推荐配置： |\
| | | | | |\
| | | | |* 积分配额 |\
| | | | |* 语音通话时长配额（复刻音色） |
|^^|^^| | |^^| \
| | |复刻音色 |按复刻音色计费 | |
| | | | | | \
|**已购买** |**已购买** |系统音色 |按系统音色计费 |\
| | | |:::tip 说明 |\
| | | |如果工作流或多 Agent 中使用了不同音色，节点触发复刻音色后，后续节点均按**复刻音色**计费，即使切换回系统音色，计费标准不变。 |\
| | | |::: |推荐配置： |\
| | | | | |\
| | | | |* 积分配额 |\
| | | | |* 语音通话时长配额（系统音色） |\
| | | | |* 语音通话时长配额（复刻音色）。 |
|^^|^^| | |^^| \
| | |复刻音色 |按复刻音色计费 | |

## 查看设备流水详情 {#c436a31c}
通过查看设备流水详情，你可以详细了解设备的费用构成和资源使用情况，便于精细化管理。
在**用量明细及管控**页面，单击对应设备右侧操作列的**流水**，可以查看该设备在指定时间范围内，每天的用量流水详情，包括日期、计费项、用量和金额。计费项包括：RTC 实时音视频费用、ASR 语音合成费用、TTS 语音识别费用、大模型费用。
![Image=400x385](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/374f81da033e4d5389414b50f457c7a9~tplv-goo7wpa0wc-image.image)