jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的直播云查询直播流推流记录

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >查询直播流推流记录

#  查询直播流推流记录

最近更新时间: 2021-11-02 15:23:28

# 接口描述

查询目标直播流在一段时间内的推流记录

# 请求参数

    
    
    GET /v2/hubs/<hub>/streams/<encodedStreamTitle>/historyactivity?start=<start>&end=<end>
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
start | int64 | 否 | 开始时间，Unix时间戳，默认为0  
end | int64 | 否 | 结束时间，Unix时间戳，默认为当前时间  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
items | object[] | 直播流推流记录列表  
├─ start | int64 | 推流开始时间，Unix时间戳  
├─ end | int64 | 推流结束时间，Unix时间戳  
├─ clientIP | string | 推流端IP  
├─ serverIP | string | 服务端IP  
  
# 示例

请求体:

    
    
    GET /v2/hubs/test/streams/dGltZXN0YW1w/historyactivity?end=1635164952&start=1635078552 HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    {
        "items":[
            {
                "start": 1635162331,
                "end": 1635164952,
                "clientIP": "127.0.0.1:19866",
                "serverIP": "127.0.0.1:1935"
            },
            {
                "start": 1635161931,
                "end": 1635162330,
                "clientIP": "127.0.0.1:10002",
                "serverIP": "127.0.0.1:1935"
            }
        ]
    }
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询流统计数据

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >查询流统计数据

#  查询流统计数据

最近更新时间: 2023-02-13 14:24:54

# 接口描述

查询直播流历史码率、历史帧率、播放人数、播放带宽、域名级别人数带宽等信息。

# 请求参数

    
    
    GET /v2/hubs/<Hub>/streams/<EncodedStreamKey>/stats?start=<Start>&end=<End>
    Host: pili.qiniuapi.com
    Authorization: <QiniuToken>
    

`<QiniuToken>`:
管理凭证，用于鉴权。其值为符合[管理凭证](https://developer.qiniu.com/pili/api/2772/http-requests-
authentication)的字符串

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
start | int64 | 否 | 查询的起始时间 (该接口只能获取一天的统计数据， end-start不能超过24小时)，Unix时间戳，默认当前时间前1小时  
end | int64 | 否 | 查询的结束时间 (该接口只能获取一天的统计数据， end-start不能超过24小时)，Unix时间戳，默认为当前时间  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
items | object [] | 流统计信息列表  
├─ hub | string | 流所属的直播空间名  
├─ time | integer | 统计时间， 时间戳，单位秒  
├─ stream | string | 流名  
├─ stats | object | 流具体的统计信息  
├─ bps | integer | 推流码率  
├─ videoFps | integer | 推流视频帧率  
├─ audioFps | integer | 推流音频帧率  
├─ width | integer | SPS 宽度  
├─ height | integer | SPS 高度  
├─ videoCodec | string | metadata视频编码规格  
├─ videoProfile | string | metadata视频编码配置  
├─ videoFrameRate | integer | SPS视频帧率  
├─ audioCodec | string | metadata音频编码规格  
├─ audioChannel | integer | metadata音频频道数  
├─ audioSampleRate | integer | metadata音频采样率  
├─ playCount | integer | 播放人数  
├─ bandwidth | integer | 播放带宽  
├─ detailStats | object [] | 域名详细统计列表  
├─ domain | string | 域名  
├─ type | string | 域名类型  
├─ playCount | integer | 播放人数  
├─ bandwidth | integer | 播放带宽  
  
# 示例

请求体:

    
    
    GET /v2/hubs/xrtest/streams/MTEy/stats?start=1676268540&end=1676268570 HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 {
    	"items": [
    		{
    			"hub": "Hub",
    			"time": <Time>,
    			"stream": "Stream",
    			"stats": {
    				"bps": <Bps>, // 推流码率
    				"videoFps": <VideoFps>, // 推流视频帧率
    				"audioFps": <AudioFps>, // 推流音频帧率
    				"width": <Width> , // SPS宽度
    				"height": <Height> , // SPS高度
    				"videoCodec": <VideoCodec>, // metadata视频编码规格
    				"videoProfile": <VideoProfile>, // metadata视频编码配置
    				"videoFrameRate": <VideoFrameRate>, // SPS视频帧率
    				"videoBitRate": <VideoBitRate> , // 视频码率, 单位bps
    				"audioCodec": <AudioCodec> , // metadata音频编码规格
    				"audioChannel": <AudioChannel>, // metadata音频频道数
    				"audioSampleRate": <AudioSampleRate>, // metadata音频采样率
    				"audioBitRate": <audioBitRate> , // 音频码率, 单位bps
    				"playCount": <PlayCount> , // 播放人数
    				"bandwidth": <Bandwidth> , // 播放带宽
    				"detailStats": [
    					{
    						"domain": "Domain",
    						"type": "Type",
    						"playCount": "PlayCount", // 域名播放人数
    						"bandwidth": "Bandwidth" // 域名播放带宽
    					},
    				...	
    				]
    			}
    
    		},
    	...
    	]
    }
    
    // 未找到流信息返回
    200 {
    	"items": []
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云录制直播回放

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >录制直播回放

#  录制直播回放

最近更新时间: 2022-01-21 11:21:42

# 接口描述

录制目标直播流一段时间内的直播为回放文件保存在存储空间中，并指定保存时间，可选回放文件的格式有m3u8、flv和mp4。其中录制为 flv、mp4
格式需要使用多媒体处理转码服务，录制过程需要一定时间。多媒体处理服务独立计费，使用会额外产生费用，详细费用请参考[价格表
__](https://portal.qiniu.com/financial/price)

# 请求参数

    
    
    POST /v2/hubs/<hub>/streams/<encodedStreamTitle>/saveas
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "fname": <fname>,
        "start": <start>,
        "end": <end>,
        "format": "<format>",
        "pipeline": "<pipeline>",
        "notify": "<notify>",
        "expireDays": <expireDays>,
        "persistentDeleteAfterDays": <persistentDeleteAfterDays>,
        "firstTsType": <firstTsType>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
start | int64 | 否 | 开始时间，Unix 时间戳，默认为第一次直播开始时间  
end | int64 | 否 | 结束时间，Unix 时间戳，默认为当前时间  
fname | string | 否 | 文件名，为空时会随机生成一个文件名  
format | string | 否 | 文件格式，可选文件格式为：  
m3u8: HLS格式，默认值  
flv: FLV格式，将回放切片转封装为单个flv文件，异步模式  
mp4: MP4格式，将回放切片转封装为单个mp4文件，异步模式  
异步模式下，生成回放文件需要一定时间  
pipeline | string | 否 | 异步模式时，指定数据处理的队列，可以将优先级较高的任务配置到独立的队列中进行执行，参考文档：[流媒体队列 __](https://developer.qiniu.com/dora/kb/2500/streaming-media-queue-about-seven-cows)  
notify | string | 否 | 回调地址，异步模式完成任务后的回调通知地址，不指定表示不做回调，参考文档：[状态查询 __](https://developer.qiniu.com/dora/1294/persistent-processing-status-query-prefop)  
同步模式下录制结果直接由接口返回，回调不生效  
expireDays | int | 否 | 切片文件的生命周期：  
0: 默认值，表示修改ts文件生命周期为永久保存  
>0: 表示修改ts文件的的生命周期为 ExpireDays 参数值  
-1: 表示不修改ts文件的expire属性，可显著提升接口响应速度  
persistentDeleteAfterDays | int | 否 | 生成文件的生命周期：  
0: 默认值，表示生成文件（m3u8/flv/mp4）永久保存  
>0: 表示生成文件（m3u8/flv/mp4）的生命周期为 PersistentDeleteAfterDays 参数值  
注意，对于m3u8文件，只有当ExpireDays为-1时，persistentDeleteAfterDays才会生效，如果设置了切片文件的生命周期，那生成m3u8文件的生命周期会和切片文件ts的生命周期一致  
firstTsType | byte | 否 | 过滤ts切片文件类型，部分非标准的直播流，在推流初期缺少视频帧或音频帧，过滤功能可以剔除这部分切片，  
0: 默认值，不做过滤  
1: 第一个ts切片需要是纯视频类型，不符合预期的ts切片将被跳过  
2: 第一个ts切片需要是纯音频类型，不符合预期的ts切片将被跳过  
3: 第一个ts切片需要是音视频类型，不符合预期的ts切片将被跳过  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
fname | string | 文件名  
start | int64 | 开始时间，Unix 时间戳  
end | int64 | 结束时间，Unix 时间戳  
persistentID | string | 异步任务ID  
  
# 示例

请求体:

    
    
    POST /v2/hubs/test/streams/YWJjZA==/saveas HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "fname": "test",
        "start": 1635197745,
        "end": 1635215745,
        "expireDays": -1,
        "firstTsType": 3
    }
    

返回体:

    
    
    200 OK
    
    {
        "fname": "test.m3u8",
        "start": 1635215356,
        "end": 1635215752
    }
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云保存直播截图

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >保存直播截图

#  保存直播截图

最近更新时间: 2021-11-02 15:30:43

# 接口描述

保存目标直播流在特定时间点的画面为图片，并保存在存储空间中。截图使用多媒体处理服务并独立计费，会额外产生费用，详细费用请参考[价格表
__](https://portal.qiniu.com/financial/price)

# 请求参数

    
    
    POST /v2/hubs/<hub>/streams/<encodedStreamTitle>/snapshot
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "fname": "<fname>",
        "time": <time>,
        "format": "<format>",
        "pipeline": "<pipeline>",
        "notify": "<notify>",
        "deleteAfterDays": <deleteAfterDays>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
time | int | 否 | 截图时间，Unix 时间戳，不指定则为当前时间  
fname | string | 否 | 文件名，不指定系统会随机生成  
format | string | 否 | 文件格式，默认为jpg，可取值为jpg和png  
pipeline | string | 否 | 异步模式时，指定数据处理的队列，可以将优先级较高的任务配置到独立的队列中进行执行，参考文档：[流媒体队列 __](https://developer.qiniu.com/dora/kb/2500/streaming-media-queue-about-seven-cows)  
notify | string | 否 | 回调地址，若指定回调地址，则截图动作为异步模式  
deleteAfterDays | int | 否 | 生命周期，- 0: 默认值，表示截图文件永久保存，单位：天  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
fname | string | 文件名  
persistentID | string | 异步任务ID  
  
# 示例

请求体:

    
    
    POST /v2/hubs/test/streams/YWJjZA==/snapshot HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "fname": "test",
        "time": 1632810081,
        "deleteAfterDays": 1
    }
    

返回体:

    
    
    200 OK
    
    {
        "fname": "test"
    }
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云修改直播流转码配置

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >修改直播流转码配置

#  修改直播流转码配置

最近更新时间: 2021-11-02 15:30:33

# 接口描述

设置目标直播流使用的转码配置，设置好转码配置的直播流在推流开始时会触发转码，推流过程中修改转码配置不会立即生效，需要重新推流

在播放地址后面添加 `@<ProfileName>` 即可播放相应转码流，目前可转码的配置有 `480p` 和
`720p`。使用转码服务会产生额外费用，详情费用请参考 [价格表 __](https://www.qiniu.com/prices/pili)

# 请求参数

    
    
    POST /v2/hubs/<hub>/streams/<encodedStreamTitle>/converts
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "converts":["<ProfileName>", ...]
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
converts | string[] | 是 | 转码配置，如果提交的 ProfileName 为空数组，那么之前的转码配置将被取消  
如果需要配置水印，则需要以wmt_开头，下划线后加水印模版名  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/test/streams/dGltZXN0YW1w/converts HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "converts":[
            "480p", 
            "720p"
        ]
    }
    

返回体:

    
    
    200 OK
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询直播上行流量

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 数据统计API >查询直播上行流量

#  查询直播上行流量

最近更新时间: 2021-11-02 15:30:13

# 接口描述

查询一段时间内目标直播空间、域名、区域的上行流量，延迟5分钟左右

带宽数据可以从返回的流量数据`flow`转化，计算方法为`bandwidth=flow*8/300`

# 请求参数

    
    
    GET /statd/upflow?$hub=<hub>&$domain=<domain>&$area=<area>&begin=<begin>&end=<end>&g=<g>&group=<group>&select=flow
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 必填 | 描述  
---|---|---  
begin | 是 | 开始时间，支持格式：20060102、20060102150405  
end | 否 | 结束时间，支持格式：20060102、20060102150405，超过当前时间，则以当前时间为准，时间范围为左闭右开区间  
g | 是 | 时间粒度，可取值为 5min、hour、day、month  
group | 否 | 按特定条件将返回数据分组，可取值为条件字段  
$hub | 否 | 直播空间名，条件字段，用于筛选符合条件的数据  
$domain | 否 | 域名，条件字段，用于筛选符合条件的数据  
$area | 否 | 区域，可取值为 cn(中国大陆)、hk(香港)、tw(台湾)、apac(亚太)、am(美洲)、emea(欧洲/中东/非洲)，条件字段，用于筛选符合条件的数据  
select | 是 | 值字段，用于返回需要查询的数据。可选值为flow，流量，单位：byte。带宽可以从流量转换，公式为 带宽=流量*8/时间粒度，单位：bps  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
统计返回 | object[] | 统计返回值  
├─ time | string | 时间  
├─ values | map | 数据  
不使用分组查询时形式如："values":{"flow":4527162977}，其中"flow"对应select项  
使用分组查询时形式如："values":{"SD":{"flow":4527162977}}，其中"SD"对应group项，"flow"对应select项  
  
# 示例

## 不使用分组查询

请求体:

    
    
    GET /statd/upflow?$area=!cn&$area=!hk&$hub=test&begin=20210928&end=20210930&g=day&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "flow": 4527162977,
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "flow": 5407323840,
                }
        }
    ]
    

## 使用分组查询

请求体:

    
    
    GET /statd/upflow?$hub=test&begin=20210928&end=20210930&g=day&group=hub&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "test": {"flow": 9801166150}
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "test": {"flow": 9488083085}
                }
        }
    ]
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询直播下行流量

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 数据统计API >查询直播下行流量

#  查询直播下行流量

最近更新时间: 2021-11-02 15:29:59

# 接口描述

查询一段时间内目标直播空间、域名、区域的下行流量，延迟5分钟左右

带宽数据可以从返回的流量数据`flow`转化，计算方法为`bandwidth=flow*8/300`

# 请求参数

    
    
    GET /statd/downflow?$hub=<hub>&$domain=<domain>&$area=<area>&begin=<begin>&end=<end>&g=<g>&group=<group>&select=flow
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 必填 | 描述  
---|---|---  
begin | 是 | 开始时间，支持格式：20060102、20060102150405  
end | 否 | 结束时间，支持格式：20060102、20060102150405，超过当前时间，则以当前时间为准，时间范围为左闭右开区间  
g | 是 | 时间粒度，可取值为 5min、hour、day、month  
group | 是 | 按特定条件将返回数据分组，可取值为条件字段  
$hub | 否 | 直播空间名，条件字段，用于筛选符合条件的数据  
$domain | 否 | 域名，条件字段，用于筛选符合条件的数据  
$area | 否 | 区域，可取值为 cn(中国大陆)、hk(香港)、tw(台湾)、apac(亚太)、am(美洲)、emea(欧洲/中东/非洲)，条件字段，用于筛选符合条件的数据  
select | 是 | 值字段，用于返回需要查询的数据。可选值为flow，流量，单位：byte。带宽可以从流量转换，公式为 带宽=流量*8/时间粒度，单位：bps  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
统计返回 | object[] | 统计返回值  
├─ time | string | 时间  
├─ values | map | 数据  
不使用分组查询时形式如："values":{"flow":4527162977}，其中"flow"对应select项  
使用分组查询时形式如："values":{"SD":{"flow":4527162977}}，其中"SD"对应group项，"flow"对应select项  
  
# 示例

## 不使用分组查询

请求体:

    
    
    GET /statd/downflow?$hub=test&begin=20210928&end=20210930&g=day&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "flow": 7150194752,
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "flow": 7093777837,
                }
        }
    ]
    

## 使用分组查询

请求体:

    
    
    GET /statd/downflow?$hub=test&begin=20210928&end=20210930&g=day&group=area&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "cn": {"flow": 7150194752}
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "cn": {"flow": 7093777837}
                }
        }
    ]
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询低延时直播下行流量

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 数据统计API
>[查询直播下行流量](https://developer.qiniu.com/pili/api/9863/live-statd-downflow) >
查询低延时直播下行流量

#  查询低延时直播下行流量

最近更新时间: 2022-03-17 14:46:28

# 接口描述

查询一段时间内目标直播空间、域名、区域的下行流量，延迟5分钟左右

带宽数据可以从返回的流量数据`flow`转化，计算方法为`bandwidth=flow*8/300`

# 请求参数

    
    
    GET /statd/downflow_rtc?$hub=<hub>&$domain=<domain>&$area=<area>&begin=<begin>&end=<end>&g=<g>&group=<group>&select=flow
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 必填 | 描述  
---|---|---  
begin | 是 | 开始时间，支持格式：20060102、20060102150405  
end | 否 | 结束时间，支持格式：20060102、20060102150405，超过当前时间，则以当前时间为准，时间范围为左闭右开区间  
g | 是 | 时间粒度，可取值为 5min、hour、day、month  
group | 是 | 按特定条件将返回数据分组，可取值为条件字段  
$hub | 否 | 直播空间名，条件字段，用于筛选符合条件的数据  
$domain | 否 | 域名，条件字段，用于筛选符合条件的数据  
$area | 否 | 区域，可取值为 cn(中国大陆)、hk(香港)、tw(台湾)、apac(亚太)、am(美洲)、emea(欧洲/中东/非洲)，条件字段，用于筛选符合条件的数据  
select | 是 | 值字段，用于返回需要查询的数据。可选值为flow，流量，单位：byte。带宽可以从流量转换，公式为 带宽=流量*8/时间粒度，单位：bps  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
统计返回 | object[] | 统计返回值  
├─ time | string | 时间  
├─ values | map | 数据  
不使用分组查询时形式如："values":{"flow":4527162977}，其中"flow"对应select项  
使用分组查询时形式如："values":{"SD":{"flow":4527162977}}，其中"SD"对应group项，"flow"对应select项  
  
# 示例

## 不使用分组查询

请求体:

    
    
    GET /statd/downflow_rtc?$hub=test&begin=20210928&end=20210930&g=day&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "flow": 7150194752,
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "flow": 7093777837,
                }
        }
    ]
    

## 使用分组查询

请求体:

    
    
    GET /statd/downflow_rtc?$hub=test&begin=20210928&end=20210930&g=day&group=area&select=flow HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "cn": {"flow": 7150194752}
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "cn": {"flow": 7093777837}
                }
        }
    ]
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询直播转码使用量

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 数据统计API >查询直播转码使用量

#  查询直播转码使用量

最近更新时间: 2021-11-02 15:29:48

# 接口描述

查询一段时间内目标直播空间、转码配置的转码时长，延迟10分钟左右

# 请求参数

    
    
    GET /statd/codec?$hub=<hub>&$profile=<profile>&begin=<begin>&end=<end>&g=<g>&group=<group>&select=duration
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded  
    

参数 | 必填 | 描述  
---|---|---  
begin | 是 | 开始时间，支持格式：20060102、20060102150405  
end | 否 | 结束时间，支持格式：20060102、20060102150405，超过当前时间，则以当前时间为准，时间范围为左闭右开区间  
g | 是 | 时间粒度，可取值为 5min、hour、day、month  
group | 是 | 按特定条件将返回数据分组，可取值为条件字段  
$hub | 否 | 直播空间名，条件字段，用于筛选符合条件的数据  
$profile | 否 | 转码配置，条件字段，用于筛选符合条件的数据  
select | 是 | 值字段，用于返回需要查询的数据。可选值为duration：转码时长，单位：毫秒  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
统计返回 | object[] | 统计返回值  
├─ time | string | 时间  
├─ values | map | 数据  
不使用分组查询时形式如："values":{"duration":4527162977}，其中"duration"对应select项  
使用分组查询时形式如："values":{"SD":{"duration":4527162977}}，其中"SD"对应group项，"duration"对应select项  
  
# 示例

## 不使用分组查询

请求体:

    
    
    GET /statd/codec?$hub=test&$profile=480p&$profile=720p&begin=20210928&end=20210930&g=day&select=duration HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded  
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "duration": 86463553,
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "duration": 86400154,
                }
        }
    ]
    

## 使用分组查询

请求体:

    
    
    GET /statd/codec?$hub=test&$profile=!480p&begin=20210928&end=20210930&g=day&group=profile&select=duration HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "720p": {"duration": 86463553}
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "720p": {"duration": 86400154}
                }
        }
    ]
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询直播鉴黄使用量

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 数据统计API >查询直播鉴黄使用量

#  查询直播鉴黄使用量

最近更新时间: 2021-11-02 15:29:38

# 接口描述

查询一段时间内目标直播空间的鉴黄次数，延迟10分钟左右

# 请求参数

    
    
    GET /statd/nrop?$assured=<false>&$hub=<hub>&begin=<begin>&end=<end>&g=<g>&group=<group>&select=count
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 必填 | 描述  
---|---|---  
begin | 是 | 开始时间，支持格式：20060102、20060102150405  
end | 否 | 结束时间，支持格式：20060102、20060102150405，超过当前时间，则以当前时间为准，时间范围为左闭右开区间  
g | 是 | 时间粒度，可取值为 5min、hour、day、month  
group | 是 | 按特定条件将返回数据分组，可取值为条件字段  
$hub | 否 | 直播空间，条件字段，用于筛选符合条件的数据  
$assured | 否 | 鉴黄结果是否确定，可取值为true或false，条件字段，用于筛选符合条件的数据  
select | 是 | 值字段，用于返回需要查询的数据，可取值为count：鉴黄次数  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
统计返回 | object[] | 统计返回值  
├─ time | string | 时间  
├─ values | map | 数据  
不使用分组查询时形式如："values":{"count":452}，其中"count"对应select项  
使用分组查询时形式如："values":{"SD":{"count":4527162977}}，其中"SD"对应group项，"count"对应select项  
  
# 示例

## 不使用分组查询

请求体:

    
    
    GET /statd/nrop?$assured=false&$hub=test&begin=20210928&end=20210930&g=day&select=count HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "count": 0,
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "count": 0,
                }
        }
    ]
    

## 使用分组查询

请求体:

    
    
    GET /statd/nrop?$assured=false&$assured=true&$hub=test&begin=20210928&end=20210930&g=day&group=hub&select=count HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    [
        {
            "time": "2021-09-28T00:00:00+08:00",
            "values":
                {
                    "test": {"count": 8653}
                }
        },
        {
            "time": "2021-09-29T00:00:00+08:00",
            "values":
                {
                    "test": {"count": 8654}
                }
        }
    ]
    

# SDK

七牛云 SDK 已集成该接口功能，可以更方便的调用，前往[下载 __](https://github.com/qiniu/go-sdk)

以上内容是否对您有帮助？