查询指定 WTN 应用在特定时间段内的转码时长数据（分钟数），支持按业务 ID、分辨率、区域进行聚合统计。

注意事项

QPS 限制：一个租户每秒最多可以提交 20 个请求。

数据延迟：数据存在约 6 个小时的延迟。

请求说明

请求方式：POST

请求地址：https://rtc.volcengineapi.com?Action=DescribeWTNTranscodeDurationData&Version=2023-11-01

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	DescribeWTNTranscodeDurationData	接口名称。当前 API 的名称为 DescribeWTNTranscodeDurationData。
Version	String	是	2023-11-01	接口版本。当前 API 的版本为 2023-11-01。

Body

参数	类型	是否必选	示例值	描述
AppID	String	是	68abcf6cb7da8a0f8457****	应用 ID。在 WTN 控制台上获取。
StartTime	String	是	2025-12-13T00:00:00+08:00	查询起始时间戳。注意必须为 RFC3339 格式的时间戳，精度为秒。最多可查询 366 天内的数据。
EndTime	String	是	2025-12-13T00:00:00+08:00	查询结束时间戳。注意必须为 RFC3339 格式的时间戳，精度为秒。不得早于 StartTime，且单次查询的时间跨度不能超过 93 天。
BusinessIDList	Array of String	否	["live-a.example.com", "live-b.example.com"]	业务 ID 列表。若不传入，则查询指定 AppID 下所有业务 ID 的转码时长用量数据。最多支持传入 5 个业务 ID。注意请确保已创建业务 ID，并在创建发布/订阅流时传入了业务 ID，否则不支持按业务 ID 统计流量。详细操作，请参见使用 Business ID 统计流量。
Resolution	Array of String	否	["audio", "480P.H264", "720P.H264", "1080P.H264", "2K.H264", "4K.H264"]	视频分辨率档位列表，对齐计费维度的分辨率规格和范围。不填表示查询所有分辨率档位。支持的取值如下： audio 480P.H264 720P.H264 1080P.H264 2K.H264 4K.H264
RegionList	Array of String	否	["cn", "use", "ap"]	WTN 转码任务所属区域的列表。不填表示所有区域。支持的取值如下： cn：中国 use：美东 ap：亚太
Aggregation	Integer	否	3600	数据聚合的时间粒度，单位为秒。支持的取值如下： 3600：1 小时。 86400：1 天。如果未传入，默认规则如下：查询时间跨度超过 1 天，默认为 1 天（86400）。查询时间跨度不超过 1 天，默认为 1 小时（3600）。
DetailField	Array of String	否	["business_id", "resolution"]	数据分组维度。不填表示只返回汇总数据，不包含数据分组详情。支持的取值如下： business_id：按业务 ID 分组。 resolution：按分辨率分组。 region: 按区域分组。

返回参数

参数	类型	示例值	描述
AppID	String	68abcf6cb7da8a0f8457****	WTN 应用 ID。
StartTime	String	2025-12-13T00:00:00+08:00	查询的开始时间，RFC3339 格式的时间戳，精度为秒。
EndTime	String	2025-12-13T00:00:00+08:00	查询的开始时间，RFC3339 格式的时间戳，精度为秒。
BusinessIDList	Array of String	["live-a.example.com", "live-b.example.com"]	业务 ID 列表。
Resolution	Array of String	["audio", "480P.H264", "720P.H264", "1080P.H264", "2K.H264", "4K.H264"]	视频分辨率档位列表。
RegionList	Array of String	["cn", "use", "ap"]	WTN 转码任务所属区域的列表。
Aggregation	Integer	3600	数据聚合的时间粒度，单位为秒。 3600：1 小时。 86400：1 天。
DetailField	Array of String	["business_id"]	本次查询的数据分组维度： business_id：按业务 ID 分组。 resolution：按分辨率分组。 region：按区域分组。
TotalDuration	Integer	1200	查询时间范围内的总转码时长。单位：分钟。
DurationList	Array of DurationList	见返回示例	按时间粒度（Aggregation）聚合后的转码时长数据列表。
DurationDetailList	Array of DurationDetailList	见返回示例	按维度（DetailField）分组后的详细数据列表。

DurationList

参数	类型	示例值	描述
TimeStamp	String	2022-04-13T00:00:00+08:00	数据按时间粒度聚合时，每个时间粒度的开始时间，RFC3339 格式的时间戳，精度为秒。
Duration	Integer	10	当前聚合时间粒度内的总转码时长（向上取整），单位分钟。

DurationDetailList

参数	类型	示例值	描述
BusinessID	String	live-a.example.com	业务 ID。
Resolution	String	720P.H264	分辨率档位。
Region	String	cn	WTN 转码任务所属区域。
TotalDuration	Integer	120	按维度进行数据分组后，当前维度的总转码时长，单位为分钟。
DurationList	Array of DurationList	见返回示例	按维度进行数据分组后，当前维度下按时间粒度的数据。

请求示例

查询 AppID 68abcf6cb7da8a0f8457**** 下，业务 ID 为 live-a.example.com，分辨率为 720P.H264 的资源在指定时间范围内的转码时长。查询结果按 1 小时（3600 秒）的时间粒度进行聚合，并按 business_id 和 resolution 维度进行拆分展示。

返回示例

WebRTC 传输网络