jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的直播云HDL (HTTP-FLV) 播放地址

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 >
[直播地址](https://developer.qiniu.com/pili/api/3691/live-address) > HDL (HTTP-
FLV) 播放地址

#  HDL (HTTP-FLV) 播放地址

最近更新时间: 2021-10-29 15:54:01

使用 HDL 观看直播的地址

# 格式

未开启时间戳防盗链：

    
    
    https://<HDLPlayDomain>/<Hub>/<streamTitle>.flv
    

开启时间戳防盗链：

    
    
    https://<HDLPlayDomain>/<Hub>/<streamTitle>.flv?sign=<md5(key+path+t).to_lower()>&t=<hex(time).to_lower()>
    

# 参数说明

参数名称 | 说明  
---|---  
HDLPlayDomain | 直播空间绑定的 HDL 直播域名  
Hub | 直播空间名称  
streamTitle | 直播流名称  
sign | 开启时间戳防盗链时的加密字符串，生成方法见[播放地址时间戳防盗链](https://developer.qiniu.com/pili/api/9868/play-security)  
t | 开启时间戳防盗链时的播放地址过期时间，格式为经过16进制转换的UNIX时间戳，具体见[播放地址时间戳防盗链](https://developer.qiniu.com/pili/api/9868/play-security)  
  
# 示例

未开启时间戳防盗链：

    
    
    http://pili-hdl.pilitest.com/testHub/testStream.flv
    

开启时间戳防盗链：

    
    
    http://pili-hdl.pilitest.com/testHub/testStream.flv?sign=65667901baf24fbb6fae8dec6acd86b0&t=61769c40
    

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云直播封面地址

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 >
[直播地址](https://developer.qiniu.com/pili/api/3691/live-address) > 直播封面地址

#  直播封面地址

最近更新时间: 2017-03-17 14:51:14

简介：

直播封面的内容会随着直播的进行自动更新。

格式：

    
    
    http://<SnapshotPlayDomain>/<Hub>/<StreamKey>.jpg
    

说明：

参数名称 | 说明  
---|---  
SnapshotPlayDomain | 直播空间绑定的直播封面域名  
Hub | 直播空间名  
StreamKey | 流名  
  
示例：

    
    
    http://live-snapshot.test.com/PiliSDKTest/streamkey.jpg
    

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询直播空间列表

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播空间管理API >查询直播空间列表

#  查询直播空间列表

最近更新时间: 2021-11-01 20:13:20

# 接口描述

查询您所有的直播空间，结果以列表形式返回

# 请求参数

    
    
    GET /v2/hubs
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>  
    Content-Type: application/x-www-form-urlencoded 
    

# 返回数据

参数 | 类型 | 描述  
---|---|---  
Items | []object | 直播空间列表  
├─ Name | string | 直播空间名  
  
# 示例

请求体:

    
    
    GET /v2/hubs HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>  
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    {
        "items": [
            {
                "name": "testhub"
            },
            {
                "name": "testhub2"
            }
        ]
    }
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播空间管理API >修改直播空间推流鉴权配置

#  修改直播空间推流鉴权配置

最近更新时间: 2021-11-01 20:13:54

# 接口描述

修改目标直播空间的推流鉴权方式和密钥

# 请求参数

    
    
    POST /v2/hubs/<hub>/security
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "publishSecurity":"<publishSecurity>",
        "publishKey":"<publishKey>"
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
PublishSecurity | string | 是 | 鉴权方式，可选推流鉴权类型为: expiry: 限时鉴权、expiry_sk: 限时鉴权SK  
PublishKey | string | 是 | 密钥  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/security HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "publishSecurity":"expiry",
        "publishKey":"12345678"
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云修改直播空间 hls 低延迟配置

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播空间管理API >修改直播空间 hls 低延迟配置

#  修改直播空间 hls 低延迟配置

最近更新时间: 2021-11-01 20:13:36

# 接口描述

对目标直播空间下的直播流开启或关闭hls低延迟

# 请求参数

    
    
    POST /v2/hubs/<hub>/hlsplus
    Host: pili.qiniuapi.com
    Authorization: <QiniuToken>  
    Content-Type: application/json 
    
    {
        "hlsPlus":<true>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
HlsPlus | bool | 是 | 是否开启 hls 低延迟  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/hlsplus HTTP/1.1
    Host: pili.qiniuapi.com
    Authorization: <QiniuToken>  
    Content-Type: application/json 
    
    {
        "hlsPlus":true
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播空间管理API >修改直播空间存储配置

#  修改直播空间存储配置

最近更新时间: 2021-11-01 20:13:45

# 接口描述

修改目标直播空间绑定的存储空间，以及直播存储保存时间，绑定的存储空间需要预先在七牛云存储中创建

# 请求参数

    
    
    POST /v2/hubs/<hub>/persistence
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "storageBucket":"<storageBucket>",
        "liveDataExpireDays":<liveDataExpireDays>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
StorageBucket | string | 是 | 存储空间，与直播空间绑定的存储空间需要满足以下两个条件  
\- 存储区域为华北  
\- 存储空间的访问控制设置为公开  
LiveDataExpireDays | uint | 是 | 存储过期时间，单位：天，取值范围为60 ~ 1095   
根据国家相关规定，电商直播客户的直播存储时长需要为1095天  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/persistence HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "storageBucket":"test1z0",
        "liveDataExpireDays":60
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播空间管理API >修改直播空间封面配置

#  修改直播空间封面配置

最近更新时间: 2021-11-01 20:14:09

# 接口描述

设置目标直播空间下的直播流是否使用直播封面，以及修改封面更新时间间隔

# 请求参数

    
    
    POST /v2/hubs/<hub>/snapshot
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "snapshotInterval":<snapshotInterval>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
SnapshotInterval | int | 是 | 间隔时间，单位：秒，设置为-1时为不开启封面  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/snapshot HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "snapshotInterval":30
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云查询域名列表

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >查询域名列表

#  查询域名列表

最近更新时间: 2021-11-01 20:14:29

# 接口描述

返回目标直播空间下的所有直播域名，以列表形式返回

# 请求参数

    
    
    GET /v2/hubs/<hub>/domains
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
Domains | []object | 域名列表  
├─ Type | string | 域名类型，包括：  
publishRtmp：推流域名  
liveRtmp：RTMP播放域名  
liveHls：HLS播放域名  
liveHdl：FLV播放域名  
├─ Domain | string | 域名  
├─ Cname | string | CNAME  
├─CertEnable | bool | 是否配置 SSL 证书  
├─ CertName | string | 证书名称  
  
# 示例

请求体:

    
    
    GET /v2/hubs/testhub/domains HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    {
        "domains": [
            {
                "type": "publishRtmp",
                "domain": "pili-publish.testhub.cloudvdn.com",
                "cname": "pili-publish.testhub.cloudvdn.com.publish.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            },
            {
                "type": "liveRtmp",
                "domain": "pili-live-rtmp.testhub.cloudvdn.com",
                "cname": "pili-live-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            },
            {
                "type": "liveHls",
                "domain": "pili-live-hls.testhub.cloudvdn.com",
                "cname": "pili-live-hls.testhub.cloudvdn.com.live-hls.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            },
            {
                "type": "publishRtmp",
                "domain": "pili-publish.test3.qbox.net",
                "cname": "pili-publish.test3.qbox.net.publish.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            },
            {
                "type": "liveRtmp",
                "domain": "pili-live-hw-rtmp.testhub.cloudvdn.com",
                "cname": "pili-live-hw-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            },
            {
                "type": "liveRtmp",
                "domain": "pili-live-b-rtmp.testhub.cloudvdn.com",
                "cname": "pili-live-b-rtmp.testhub.cloudvdn.com.live-rtmp.z0.pili.pilidns.com",
                "certEnable": false,
                "certName": ""
            }
        ]
    }
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云绑定直播域名

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >绑定直播域名

#  绑定直播域名

最近更新时间: 2021-11-01 20:14:59

# 接口描述

添加直播域名到目标直播空间，包括推流域名与RTMP、HLS、HDL播放域名，绑定之后可以使用此域名推流或播放

# 请求参数

    
    
    POST /v2/hubs/<hub>/newdomains
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "domain":"<domain>",
        "Type":"<type>"
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
Domain | string | 是 | 域名  
Type | string | 是 | 域名类型，可选域名类型为：  
publishRtmp：推流域名  
liveRtmp：RTMP播放域名  
liveHls：HLS播放域名  
liveHdl：FLV播放域名  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/newdomains HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "domain":"pili-publish.test.cloudvdn.com",
        "Type":"liveRtmp"
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云解绑直播域名

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >解绑直播域名

#  解绑直播域名

最近更新时间: 2021-11-01 20:15:11

# 接口描述

将已经绑定的直播域名从目标直播空间解绑，之后无法使用此域名推流或播放

# 请求参数

    
    
    DELETE /v2/hubs/<hub>/domains/<domain>
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
Domain | string | 是 | 域名  
  
# 返回数据

空

# 示例

请求体:

    
    
    DELETE /v2/hubs/test-hub/domains/pili-publish.go-sdk.cloudvdn.com HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    

返回体:

    
    
    200 OK
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云绑定点播域名

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >绑定点播域名

#  绑定点播域名

最近更新时间: 2021-11-01 20:15:21

# 接口描述

点播域名用于访问直播空间对应的存储空间中的内容，例如回放、截图文件

请在相应存储空间配置好可用域名后，将其绑定到直播空间。若未正确配置点播域名，可能无法正常使用回放录制、保存截图等功能

# 请求参数

    
    
    POST /v2/hubs/<hub>/voddomain
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "vodDomain":"<vodDomain>"
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
vodDomain | string | 是 | 点播域名  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/voddomain HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json 
    
    {
        "vodDomain":"pili-vod.testhub.cloudvdn.com"
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >修改域名证书配置

#  修改域名证书配置

最近更新时间: 2021-11-01 20:15:33

# 接口描述

修改域名证书配置，需要提前将证书配置到七牛 CDN 服务中，证书配置地址: https://portal.qiniu.com/certificate/ssl

配置好证书后可以获得证书名称的参数，此时可以使用获得的证书名称请求执行修改域名证书配置

# 请求参数

    
    
    POST /v2/hubs/<hub>/domains/<domain>/cert
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "certName":"<certName>"
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
Domain | string | 是 | 域名  
CertName | string | 是 | 证书名称，需要将证书配置到七牛 CDN 服务中  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/domains/pili-publish.test.cloudvdn.com/cert HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "certName":"5f1e9dc7f9537d6b370xx010"
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

以上内容是否对您有帮助？
human: 如何处理七牛云的直播云修改域名改写规则配置

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 域名管理API >修改域名改写规则配置

#  修改域名改写规则配置

最近更新时间: 2021-11-01 20:15:42

# 接口描述

可根据业务需求自定义推拉流URL，改写后的URL应符合七牛的直播URL规范:
`<scheme>://<domain>/<hub>/<stream>[.<ext>]?<query>`

# 请求参数

    
    
    POST /v2/hubs/<hub>/domains/<domain>/urlrewrite
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "rules":[
            {
                "pattern":"<pattern>",
                "replace":"<replace>"
            }
        ]
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
Hub | string | 是 | 直播空间名  
Domain | string | 是 | 域名  
Rules | []object | 是 | URL 改写规则列表  
├─ Pattern | string | 是 | 匹配规则，针对完整URL的正则表达式，形式如：(.+)/live/(.+)/playlist.m3u8，括号中的内容允许在 Replacement 中使用${n}引用（n表示括号顺序）  
├─ Replace | string | 是 | 改写规则，希望得到的改写结果，形式如：${1}/hub/${2}.m3u8，改写后的URL应符合七牛的直播URL规范: `<scheme>://<domain>/<hub>/<stream>[<ext>]?<query>`  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/testhub/domains/pili-publish.test.com/urlrewrite HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/json 
    
    {
        "rules":[
            {
                "pattern":"(.+)/test/(.+)",
                "replace":"${1}/test/live/${2}"
            }
        ]
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >创建直播流

#  创建直播流

最近更新时间: 2021-11-02 15:21:57

# 接口描述

创建一个直播流，推流时如果流不存在，系统会自动创建一个流。

# 请求参数

    
    
    POST /v2/hubs/<Hub>/streams
    Host: pili.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "key": "<StreamTitle>"
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
key | string | 是 | StreamTitle 直播流名，需要满足的条件为 `4-200个数字或字母`  
  
# 返回数据

    
    
    200 {}
    
    614 {
        "error": "stream already exists"
    }
    

# 示例

请求体：

    
    
    POST /v2/hubs/test/streams HTTP/1.1
    Host: pili.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {"key":"testkey"}
    

返回体：

    
    
    200 OK
    

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

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

#  查询直播流列表

最近更新时间: 2021-11-02 15:22:10

# 接口描述

查询目标直播空间下的直播流列表，可以根据直播流在线状态和直播流名称进行筛选

# 请求参数

    
    
    GET /v2/hubs/<Hub>/streams?liveonly=<true>&prefix=<prefix>&limit=<limit>&marker=<marker>
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>  
    Content-Type: application/x-www-form-urlencoded 
    

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
liveonly | bool | 否 | 只返回当前在线的流，true 表示查询的是正在直播的流，不指定表示返回所有的流  
prefix | string | 否 | 流名称前缀匹配  
limit | int | 否 | 返回值数量限制，取值范围0～5000  
marker | string | 否 | 游标，表示从该位置开始返回  
  
# 返回数据

名称 | 类型 | 描述  
---|---|---  
items | object [] | 直播流列表  
├─ key | string | 直播流名称  
marker | string | 游标，表示当前位置，若marker为空，表示遍历完成  
  
# 示例

请求体:

    
    
    GET /v2/hubs/test/streams?limit=10&liveonly=true HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    {
        "items": [
            {
                "key": "stream1"
            }, 
            {
                "key": "stream2"
            },
            {
                "key": "stream3"
            }
        ],
        "marker": "" 
    }
    

# SDK

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

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

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

#  查询直播流信息

最近更新时间: 2021-11-02 15:22:21

# 接口描述

查询目标直播流基本信息和配置信息

# 请求参数

    
    
    GET /v2/hubs/<hub>/streams/<encodedStreamTitle>
    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)的直播流名  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
createdAt | int64 | 直播流创建时间，Unix 时间戳  
updatedAt | int64 | 直播流更新时间，Unix 时间戳，对一个流的配置做修改操作会更新这个值  
expireAt | int64 | 直播流过期时间，默认流过期时间为15天，Unix 时间戳，过期的流会被自动清除。如您设置的默认存储过期时间是 N 天，那么一个流持续 N 天不推流就会被自动清除  
disabledTill | int | 禁播结束时间，Unix 时间戳，-1 表示永久禁播  
converts | string[] | 转码配置  
watermark | bool | 是否开启水印  
publishSecurity | string | 推流鉴权类型  
publishKey | string | 推流密钥  
nropEnable | bool | 是否开启鉴黄  
  
# 示例

请求体:

    
    
    GET /v2/hubs/test/streams/dGltZXN0YW1w HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken> 
    Content-Type: application/x-www-form-urlencoded
    

返回体:

    
    
    200 OK
    
    {
        "createdAt": 1631796534,
        "updatedAt": 1634205648,
        "expireAt": 1730108940,
        "disabledTill": 0,
        "converts": [
            "480p",
            "720p"
        ],
        "watermark": false,
        "publishSecurity": "",
        "publishKey": "",
        "nropEnable": false,
    }
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >禁用直播流

#  禁用直播流

最近更新时间: 2023-07-04 18:39:03

# 接口描述

禁播或者解禁目标直播流，支持限时禁播或永久禁播

# 请求参数

    
    
    POST /v2/hubs/<hub>/streams/<encodedStreamTitle>/disabled
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "disabledTill": <disabledTill>
        "disablePeriodSecond": <disablePeriodSecond>
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
encodedStreamTitle | string | 是 | 经过[base64编码](https://developer.qiniu.com/kodo/manual/appendix)的直播流名  
disabledTill | int | 是 | 禁播结束时间，Unix 时间戳，特殊值含义： -1 永久禁播；0 解除禁播  
disablePeriodSecond | int | 否 | 禁播时长，单位：秒，当 disabledTill 为0时，disablePeriodSecond 参数生效，值大于0  
  
# 返回数据

空

# 示例

请求体:

    
    
    POST /v2/hubs/test/streams/dGltZXN0YW1w/disabled HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "disabledTill": 1688469861
    }
    

返回体:

    
    
    200 OK
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >查询在线流信息

#  查询在线流信息

最近更新时间: 2022-09-08 19:22:10

# 接口描述

查询直播开始时间、主播IP、当前码率、当前帧率等信息

# 请求参数

    
    
    GET /v2/hubs/<hub>/streams/<encodedStreamTitle>/live
    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)的直播流名  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
startAt | int64 | 推流开始时间，Unix 时间戳  
clientIP | string | 推流端IP  
serverIP | string | 服务端IP  
bps | int | 推流码率  
fps | object | 帧率  
├─ audio | int | 音频帧率  
├─ video | int | 视频帧率  
├─ data | int | metadata帧率  
maxGop | int | 最近30秒内GOP最大值，单位：毫秒  
avgGop | int | 最近30秒内GOP平均值，单位：毫秒  
videoBitRate | int | 视频码率，单位：bps  
audioBitRate | int | 音频码率，单位：bps  
location | string | 推流端所在地区  
isp | string | 推流端所在运营商  
playCount | int64 | 播放人数  
bandwidth | int64 | 播放带宽，单位：bps  
  
# 示例

请求体:

    
    
    GET /v2/hubs/test/streams/dGltZXN0YW1w/live HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded 
    

返回体:

    
    
    200 OK
    
    {
        "startAt": 1635162331,
        "clientIP": "127.0.0.1:19866",
        "serverIP": "127.0.0.1:1935",
        "bps": 601344,
        "videoBitRate": 601251,
        "audioBitRate": 14148,
        "maxGop": 1000,
        "avgGop": 1000,
        "location": "上海",
        "isp": "电信",
        "playCount": 10,
        "bandwidth": 6012510,
        "fps": {
            "audio": 43,
            "video": 60,
            "data": 0
        }
    } // 流不在线时返回也为200，各值为零值
    
    404 {
        "error": "not found" // 未找到流
    }
    
    
    

# SDK

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

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

gpt: [直播云](https://developer.qiniu.com/pili) > API 文档 > 直播流管理API >批量查询在线流信息

#  批量查询在线流信息

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

# 接口描述

批量查询直播的开始时间、主播IP、当前码率、当前帧率等信息

# 请求参数

    
    
    POST /v2/hubs/<hub>/livestreams
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "items": ["<StreamTitle1>", "<StreamTitle2>", ...]
    }
    

参数 | 类型 | 必填 | 描述  
---|---|---|---  
hub | string | 是 | 直播空间名  
items | string[] | 是 | 直播流列表，查询直播流列表数量不超过100  
  
# 返回数据

参数 | 类型 | 描述  
---|---|---  
items | object[] | 直播流列表  
├─ startAt | int64 | 推流开始时间，Unix 时间戳，单位：秒  
├─ clientIP | string | 推流端IP  
├─ serverIP | string | 服务端IP  
├─ bps | int | 推流码率  
├─ fps | object | 帧率  
├─ audio | int | 音频帧率  
├─ video | int | 视频帧率  
├─ data | int | metadata帧率  
├─ key | string | 直播流名  
  
# 示例

请求体:

    
    
    POST /v2/hubs/test/livestreams HTTP/1.1
    Host: pili.qiniuapi.com 
    Authorization: <QiniuToken>
    Content-Type: application/json
    
    {
        "items": ["teststream"]
    }
    

返回体:

    
    
    200 OK
    
    {
        "items": [
            {
               "startAt": 1635162331,
               "clientIP": "127.0.0.1:19866",
               "serverIP": "127.0.0.1:1935",
               "bps": 604168,
               "fps": {
                    "audio": 43,
                    "video": 60,
                    "data": 0
                },
                "key": "teststream"
            }
        ]
    }
    

# SDK

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

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