终端用户用量查询和配额管控

本文介绍如何在 API Playground 页面查看终端用户的用量数据、用量明细、管理设备配额以及查看设备流水详情。以便开发者清晰掌握终端用户资源使用状况，从而实现精细化管理。

设备概览

通过设备概览页面，你可以快速了解设备的日活数、对话次数、语音转文字用量、文字转语音用量、实时音视频用量等关键指标，从而分析设备使用情况并优化资源配置。

1. 企业超级管理员或管理员登录扣子编程。

2. 在左下角单击个人头像，选择企业> 团队与企业管理。
   

3. 在左侧导航栏中选择设备管理页签，在设备概览页面，在顶部选择统计维度和时间段，支持查看近 7 天、近 30 天和近 60 天的数据。
   统计维度默认为按设备维度进行统计，你也可以选择按自定义维度。如果选择按自定义维度，需要先在 OAuth JWT 授权的 Payload 中设置 custom_consumer 参数，用于设置用量统计的自定义维度，具体请参见 OAuth JWT 授权（开发者）。
   

   图表名称	说明
   日活数	在指定时间段内，与设备内的智能体进行过对话的设备数。
   对话次数	统计所有设备在指定时间段内的有效对话次数，以及每台设备的日均用量。 每台设备的日均用量 = 时间段内的总对话次数 / 时间段内的天数 / 日活数。 有效对话次数是指用户询问后，设备中的智能体进行了回应，即计为一次有效对话。
   ASR 语音转文字用量（分钟）	所有设备在指定时间段内，每天进行语音转文字操作的总时长，以及每台设备的日均用量。 每台设备的日均用量 = 时间段内的总 ASR 语音转文字总用量 / 时间段内的天数 / 日活数。
   TTS 文字转语音用量（字符数）	所有设备在指定时间段内，每天将文字转换为语音的字符数量，以及每台设备的日均用量。 每台设备的日均用量 = 时间段内的 TTS 文字转语音总用量 / 时间段内的天数 / 日活数。
   RTC 实时音频用量（分钟）	所有设备在指定时间段内每天的音频通话时长，以及每台设备的日均用量。 每台设备的日均用量 = 时间段内的 RTC 实时音频总用量 / 时间段内的天数 / 日活数。
   RTC 实时视频用量（分钟）	所有设备在指定时间段内每天的视频频通话时长，以及每台设备的日均用量。 每台设备的日均用量 = 时间段内的 RTC 实时视频总用量 / 时间段内的天数 / 日活数。

查询用量明细

在团队与企业管理的设备管理页签中，单击用量明细及管控页签，可以查看各个设备最近 1 天或最近 7 天的用量明细。

明细列表中的参数说明如下：

管理设备配额

你可以为每台设备设置免费使用额度，以便用户在初始阶段免费体验设备功能，同时避免资源的过度使用。通过合理的额度配置，既能满足用户的试用需求，又能有效控制资源消耗。

在用量明细及管控页面，单击右上角的全局配额（设备维度），可以配置设备的配额，对你所在火山引擎主账号下的所有设备生效，支持按积分维度或语音通话时长维度设置配额。

配置示例：
例如你可以设置每个设备累计额度为 5000 积分，每天可用 500 积分。当设备 A 在某一天的使用积分达到 500 上限后，设备 A 当天将无法继续使用，需等到次日才能恢复使用，当设备 A 的累计使用积分达到 5000 上限后，设备 A 将无法继续使用。
参数说明：

不同场景的计费和配额说明如下表所示。

查看设备流水详情

通过查看设备流水详情，你可以详细了解设备的费用构成和资源使用情况，便于精细化管理。
在用量明细及管控页面，单击对应设备右侧操作列的流水，可以查看该设备在指定时间范围内，每天的用量流水详情，包括日期、计费项、用量和金额。计费项包括：RTC 实时音视频费用、ASR 语音合成费用、TTS 语音识别费用、大模型费用。