jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的视频监控获取域名列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 域名管理相关接口 >获取域名列表

#  获取域名列表

最近更新时间: 2022-01-14 10:38:20

# **描述**

本接口用于获取域名列表

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/domains`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间名称ID  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | 域名数组 | 域名数组  
items.domain | string | 域名  
items.type | string | 域名类型  
items.cname | string | cname  
items.state | integer | 0: 未配置CNAME，1: 可用，2: 不可用  
items.isDefault | boolean | 是否默认域名  
items.createdAt | integer | 创建时间，Unix时间戳，秒  
items.playSecurity | playSecurity | 时间戳防盗链  
items.playSecurity.open | boolean | 时间戳防盗链开关  
items.playSecurity.primary | string | 时间戳防盗链主KEY  
items.playSecurity.secondary | string | 时间戳防盗链备用KEY  
items.playSecurity.expireAfter | integer | 防盗链过期时长（单位：秒）  
items.httpsSwitch | httpsSwitch | https开关  
items.httpsSwitch.httpsOpen | boolean | https开关  
items.httpsSwitch.certid | string | 证书id  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取证书列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 域名管理相关接口 >获取证书列表

#  获取证书列表

最近更新时间: 2020-07-06 11:32:40

# **描述**

本接口用于查询用户已购买或已上传的自有证书的列表

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/domains/{domain}/certs`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间名称ID  
domain | 是 | string | 域名  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | 证书数组 | 证书数组  
items.certid | string | 证书id  
items.name | string | 证书名称  
items.notBefore | int64 | 证书有效期起始时间  
items.notAfter | int64 | 证书有效期截止时间  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控域名对应的HTTPs开关

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 域名管理相关接口 >域名对应的HTTPs开关

#  域名对应的HTTPs开关

最近更新时间: 2020-07-08 14:41:27

# **描述**

本接口用于开启或关闭域名对应的HTTPs开关

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/domains/{domain}/ssls`
  * 使用场景：当用户有安全需求时，可通过此开关开启或关闭HTTPs保证安全可靠

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间名称ID  
domain | 是 | string | 域名  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
certid | 是 | string | 证书Id  
httpsOpen | 是 | boolen | https开关  
  
# **响应参数**

200

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取域名信息

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 域名管理相关接口 >获取域名信息

#  获取域名信息

最近更新时间: 2020-12-16 12:05:21

# **描述**

本接口用于查询域名相关信息(cname，时间戳防盗链，https配置)。涉及域名的API，仅适用于空间模式为“静态地址”的空间。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/domains/{domain}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间名称ID  
domain | 是 | string | 域名  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
domain | Object | 域名信息  
domain.domain | string | 域名  
domain.type | string | 域名类型 "publishRtmp":rtmp推流, "liveRtmp": rtmp播放, "liveHls": HLS, "liveHdl": HDL   
domain.cname | integer | cname  
domain.state | integer | 0: 未配置CNAME，1: 可用，2: 不可用  
domain.isDefault | boolean | 是否默认域名  
domain.createdAt | integer | 创建时间  
domain.playSecurity | object | 时间戳防盗链  
domain.playSecurity.open | boolean | 时间戳防盗链开关  
domain.playSecurity.primary | string | 主KEY  
domain.playSecurity.secondary | string | 备用KEY  
domain.httpsSwitch | object | https开关  
domain.httpsSwitch.certid | string | 证书id  
domain.httpsSwitch.httpsOpen | boolean | https开关  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控启动按需录制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >启动按需录制

#  启动按需录制

最近更新时间: 2022-05-10 18:31:33

# **描述**

本接口用于对指定流启动按需录制。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/record/start`
  * 本接口需要空间绑定`按需录制`类型的模板，或者流本身绑定`按需录制`模板。当用户想在每天9：00到12：00进行流录制，可分别在对应时间点通过本接口和[停止按需录制 __](https://developer.qiniu.com/qvs/6744/stop-record-stream)组合使用。
  * 本接口的效果，包含了2步，[`启动设备拉流` __](https://developer.qiniu.com/qvs/6907/start-device)+`开始录像`；所以调用了本接口，不需要在调用`启动设备拉流`API

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流Id  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/streams/31011500991320000028/record/start \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' 
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控停止按需录制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >停止按需录制

#  停止按需录制

最近更新时间: 2023-05-05 15:16:41

# **描述**

本接口用于对指定流停止按需录制， 和[开始按需录制 __](https://developer.qiniu.com/qvs/6743/start-
record-stream)配套使用。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/record/stop`
  * 本接口需要空间绑定`"按需录制"类型的模板`，或者流本身绑定`按需录制`模板。当用户想在每天9：00到12：00进行流录制，可分别在对应时间点通过[启动按需录制 __](https://developer.qiniu.com/qvs/6743/start-record-stream)和本接口组合使用。
  * 如果在停止按需录制后，需要终止设备推流，可以在调用[终止设备推流 __](https://developer.qiniu.com/qvs/6908/stop-device)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流Id  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/streams/31011500991320000028/record/stop \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' 
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除录制片段

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >删除录制片段

#  删除录制片段

最近更新时间: 2022-07-05 16:22:21

# **描述**

本接口用于删除录制视频文件

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/recordhistories`
  * 如果删除的是m3u8文件,

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
files | 是 | string数组 | 需要删除的文件列表(从[查询录制记录 __](https://developer.qiniu.com/qvs/api/6745/query-recordhistories)file 字段获取文件名)  
saveCover | 否 | bool | 是否保留视频封面,默认false, 即`不`保留  
saveTs | 否 | bool | 如果删除m3u8文件，是否保留对应的ts文件,默认false, 即`不`保留  
  
**注意** :  
一次最多可以删除1000条记录

# **响应参数**

200 OK

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/3nm4x0u6poax8/streams/31011500991320000007/recordhistories \
      --header 'authorization: QiniuStub j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"files":["record/2akrarrzns76w/t0/1587898457113-1587899058364-601408.m3u8","record/2akrarrzns76w/t0/1587899050326-1587899651641-601127.m3u8"]
    }'
    

**响应示例**

    
    
    200 OK
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控录制视频片段合并

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >录制视频片段合并

#  录制视频片段合并

最近更新时间: 2022-08-10 11:17:10

# **描述**

用于将任意时间段内的视频，剪裁或拼接合并成新的文件,格式支持m3u8(适合在线点播回放), mp4(适合下载), flv(适合下载)。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/saveas`
  * 如果生成的格式为flv或者mp4, 这是异步过程，可通过[`接收录制状态回调` __](https://developer.qiniu.com/qvs/10240/the-message-callback)来获取视频转换完成的通知， 也可以通过本接口返回的persistentID，主动查询视频处理状态。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
**请求Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
start | 是 | integer | 查询开始时间(unix时间戳,单位为秒)  
end | 是 | integer | 查询结束时间(unix时间戳,单位为秒)  
format | 是 | string | 保存的文件格式,可以为m3u8, mp4或者flv  
fname | 否 | string | 保存的文件名，不指定系统会随机生成  
pipeline | 否 | string | 数据处理的私有队列，不指定则使用公共队列  
notifyUrl | 否 | string | 保存成功回调通知地址，不指定则不通知 [通知的详细信息查考这里](https://developer.qiniu.com/dora/manual/1291/persistent-data-processing-pfop)  
deleteAfterDays | 否 | integer | 文件过期时间,默认和录制模版中的设置保持一致, `-2 表示永不过期`  
deleteTs | 否 | bool | 在不生成m3u8格式文件时是否删除对应的ts文件, 默认不删除  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
bucket | string | 文件存储的bucket  
fname | string | 表示保存后在存储空间里的文件名。使用存储空间的下载域名可以访问这文件，形如: `http://<DownloadDomainOfStorageBucket>/<Fname>`  
duration | int | 合并后文件的时长(单位为秒)  
persistentID | string | 持久化异步处理任务ID，异步模式才会返回该字段，可以通过该字段查询转码进度，[持久化处理状态查询 __](https://developer.qiniu.com/dora/manual/1294/persistent-processing-status-query-prefop)  
  
# 示例

请求包:

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/3nm4x0vyz7xlu/streams/31011500991320000129/saveas \
    	--header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"start":1601346558,
    	"end":1601347915,
    	"format":"mp4"
    }'
    

返回包:

    
    
    200 OK {
      "fname": "record/3nm4x0vyz7xlu/31011500991320000129/1601346558445-1601347917100-1301394.mp4",
      "persistentId": "z0.01z002c5zj4qq9rouo00muj6so00012w",
      "bucket": "linking_ipc_test",
      "duration": 1301
    }
    
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >录制回放

#  录制回放

最近更新时间: 2022-08-10 11:51:27

# **描述**

本接口用于查询指定时间段的录像记录进行录像回放。

请求

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceid}/streams/{streamId}/records/playback.m3u8?start=<start>&end=<end>`
  * Tips1:回放地址，优先使用七牛存储(kodo)中的自定义域名；如果没有该域名，则使用kodo默认域名；kodo默认域名过期，则无法使用。
  * Tips2:如果需要https的回放地址，需请求`https://qvs.qiniuapi.com`
  * Tips3:Get请求，通过`非SDK`方式调用的客户，http头部Content-Type, `要么设置为application/x-www-form-urlencoded`, `要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
start | 是 | integer | 查询开始时间(unix时间戳，单位为秒)  
end | 是 | integer | 查询结束时间(unix时间戳，单位为秒）  
  
# **响应参数**

参数名称 | 字段类型 | 说明  
---|---|---  
url | string | m3u8播放链接  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url 'http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/streams/31011500991320000137/records/playback.m3u8?start=1604028714&end=1604028934' \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "url": "http://prlghu509.test.bkt.clouddn.com/record/playback/2akrarxtmpned/31011500991320000137/1604028714-1604028934.m3u8?pm3u8/0/expire/7200&e=1604313929&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:gQdnnGXGivC4-z1rtnNIF20oQns"
    }
    
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控按需截图

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >按需截图

#  按需截图

最近更新时间: 2023-08-21 15:30:53

# **描述**

本接口用于对指定流立即截图一次。对于不在线的流，会启动设备拉流，不需要调用启动设备拉流API。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/snap`
  * 本接口要求截图模板类型为`按需截图`，如用户想在某时刻进行流截图操作，可在对应时间点通过调用本接口即可。
  * 本接口是异步过程，截图后的地址，可以通过两种方式获取 
    1. 我们会回调,主动通知客户截图完成后的地址，客户需要解析我们的[截图状态回调 __](https://developer.qiniu.com/qvs/10240/the-message-callback)
    2. 客户也可以通过主动查询[截图列表 __](https://developer.qiniu.com/qvs/6749/list-stream-snapshots)获取
  * 本接口会先启动设备拉流，等待3s，流在线了之后，会请求截图。如果3s内，设备没有推流到平台，截图会失败。

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流Id  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/streams/31011500991320000028/snap \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除截图

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >删除截图

#  删除截图

最近更新时间: 2022-05-20 12:30:41

# **描述**

本接口用于删除录制截图

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/snapshots`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
files | 是 | string数组 | 需要删除的文件列表(从[获取截图列表 __](https://developer.qiniu.com/qvs/api/6749/list-stream-snapshots)file字段获取文件名)  
  
**注意** :  
一次最多可以删除1000条记录

# **响应参数**

200 OK

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/3nm4x0u6poax8/streams/31011500991320000007/snapshots \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"files":["snapshot/jpg/d102sni9zryu/device005/1586828065507.jpg","snapshot/jpg/d102sni9zryu/device005/1586828070507.jpg"]
    }'
    

**响应示例**

    
    
    200 OK
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取截图列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >获取截图列表

#  获取截图列表

最近更新时间: 2022-08-10 11:18:24

# **描述**

本接口用于查询流截图记录

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/snapshots?type=<type>&start=<start>&end=<end>&marker=<marker>&line=<line>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type,`要么设置为application/x-www-form-urlencoded`,`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
type | 是 | integer | 1:实时截图对应的图片列表 2: 按需截图对应的图片列表 3:覆盖式截图对应的图片  
line | 否 | integer | 限定返回截图的个数，只能输入1-100的整数，不指定默认返回30个，type为3可忽略  
marker | 否 | string | 上一次查询返回的标记，用于提示服务端从上一次查到的位置继续查询，不指定表示从头查询，type为3可忽略  
start | 否 | integer | 查询开始时间(unix时间戳,单位为秒)，type为3可忽略  
end | 否 | integer | 查询结束时间(unix时间戳,单位秒)，type为3可忽略  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | 截图数组 | 截图数组  
items.snap | string | 截图url  
items.file | string | 对应云存储中的文件名  
items.time | integer | 截图时间点(unix时间戳 单位为秒)，覆盖式截图不返回  
marker | string | 返回的列举位置标记，作为下次列举的起点信息,为空表示全部返回完毕，覆盖式截图不返回  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/snapshots?type=1&start=1586828065&end=1586828456 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "items": [
        {
          "snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828085507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:atGE_HnerdP2TF1fDSlv2HRurcw",
          "file":"snapshot/jpg/d102sni9zryu/device005/1586828085507.jpg",
          "time": 1586828085
        }, 
        {
          "snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828461726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:AcRKnwvxxDc4kgg22RwbaiiAJYM",
          "file":"snapshot/jpg/d102sni9zryu/device005/1586828461726.jpg",
          "time": 1586828461
        }
      ],
      "marker": ""
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取直播封面截图

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 录制管理相关接口 >获取直播封面截图

#  获取直播封面截图

最近更新时间: 2022-09-13 16:26:06

# **描述**

本接口用于查询流封面

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/cover`
  * 前提:流或者流附属的空间绑定了`截图模板`, 并且截图模板的`截图方式`包含`覆盖式截图`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 空间为`gb28181`:设备类型为摄像头,流ID就是`设备国标ID`;设备类型是NVR(平台类型),流ID为`设备国标ID_通道国标ID`  
空间类型为`rtmp`或者`主动拉流`:流ID就是`流名称`  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
url | string | 封面下载地址  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarrzns76w/streams/t0/cover \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "url": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/2akrarrzns76w/t0.jpg?e=1588124787&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:bH8s5m5N5Ugp2wo6ACRUVeIK280"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控本地录像回放控制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 本地录像回放相关接口 >本地录像回放控制

#  本地录像回放控制

最近更新时间: 2022-05-16 10:58:47

# **描述**

本接口用于本地录像回放的控制，比如快进,快退,慢放,拖动播放,暂停。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}/playback/control`
  * 流ID处于`推流状态`时, `才能`使用本接口,[如何触发本地录像推流?__](https://developer.qiniu.com/qvs/6907/start-device)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID, 流ID可以从`查询本地录像列表`接口获取  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
command | 是 | string | 对历史流进行控制，包括“play”播放、“pause”暂停、“scale”倍速，暂停后需要“play”继续播放  
range | 否 | string | 当command为“play”时指定跳转的时间，单位是s，时间大小是指距离历史流开始播放后的多长时间，默认为“now”，例如：“100”，“200”等，跳转后会以1倍速继续播放  
scale | 否 | float | 当command为“scale”时指定播放倍速，支持x0.5、x1、x2、x4、x8  
  
# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --location --request POST 'http://localhost:7275/v1/namespaces/2akras1vdttwy/streams/31011500991320000006_history_1628730000_1628740800/playback/control' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "command":"pause"
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控本地录像上传云端

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 本地录像回放相关接口 >本地录像上传云端

#  本地录像上传云端

最近更新时间: 2022-04-02 17:16:45

# **描述**

本接口可将设备`SD卡本地录像文件`上传到云端。具体可参考[设备本地录像上传云端存储最佳实践
__](https://developer.qiniu.com/qvs/8425/local-video-upload-the-cloud)

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{gbId}/sdcardsave/start`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
gbId | 是 | string | 设备国标Id  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
channelId | 否 | string | 平台设备指定需要启动的通道国标ID  
start | 是 | integer | 开始时间(unix时间戳,单位为秒)  
end | 是 | integer | 结束时间(unix时间戳,单位为秒)  
processId | 否 | string | 客户自定义ID，在视频录制到云端后，七牛平台会把该ID回调给客户.[录制回调格式 __](https://developer.qiniu.com/qvs/10240/the-message-callback)  
  
**注意** :  
用户使用该接口将摄像头本地的录像通过国标推流到云端并进行录制, 首先需要保证摄像头本地是有录制文件的,可以通过[查询本地录像列表  
__](https://developer.qiniu.com/qvs/7112/query-local-video-list)获取本地录像列表

# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028/sdcardsave/start \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
      --data '{
    	"channelId": "34020000001310000003",
    	"start":1612191900,
    	"end":1612191960
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控终止本地录像上传云端

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 本地录像回放相关接口 >终止本地录像上传云端

#  终止本地录像上传云端

最近更新时间: 2021-02-02 16:13:52

# **描述**

本接口用于终止本地录制文件上传云端录制的操作。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{gbId}/sdcardsave/stop`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
gbId | 是 | string | 设备国标Id  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
channelId | 否 | string | 平台设备指定需要启动的通道国标ID  
start | 是 | integer | 开始时间(unix时间戳,单位为秒)  
end | 是 | integer | 结束时间(unix时间戳,单位为秒)  
  
**注意** : 该接口应与[本地录像上传云端 __](https://developer.qiniu.com/qvs/7765/uploaded-to-
the-cloud)配合使用

# **响应参数**

200

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices/31011500991320000028/sdcardsave/stop \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json'
      --data '{
    	"channelId": "34020000001310000003",
    	"start":1612191900,
    	"end":1612191960
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控PTZ相关接口

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > PTZ相关接口

#  PTZ相关接口

最近更新时间: 2022-11-28 11:14:53

通过国标接入的监控设备可以使用PTZ相关功能

名词解释：

名称 | 解释  
---|---  
PTZ  | 在安防监控应用中是 Pan/Tilt/Zoom 的简写，代表云台全方位（左右/上下）移动及镜头变倍、变焦控制。对于下面的操作仅要求设备在线既可，与流是否在线无关  
步长 | 步长主要是用于控制云台转动方向的速度的调节， 调节范围1~10。  
变倍（ZOOM） | 用户可以通过控制变倍参数，调整焦距的远近，得到所需的全景画面，或是近景视图。  
光圈（Irish） | 光圈是用来调节摄像机画面的亮度的。  
变焦（Focus） | 聚焦是调节摄像机画面中的一个物体或场景的清晰程度的过程  
预置位 | 摄像机能将当前状态下云台的水平角度、倾斜角度和摄像机镜头焦距等位置参数存储到存储器中，需要时可以选择该预置位，迅速调用这些参数并将云台和摄像头调整至该位置。  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控云台控制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 >
[PTZ相关接口](https://developer.qiniu.com/qvs/api/7289/ptz-related-interface) >
云台控制

#  云台控制

最近更新时间: 2022-11-28 16:22:18

本接口用于对摄像头进行 转动镜头，如水平、垂直、缩放等操作

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{deviceId}/ptz`
  * Tips: 请求参数中的cmd字段设置为`stop`时, 设备才会停止；否则会永不停歇

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
deviceId | 是 | string | 设备国标Id  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cmd | 是 | string | left(向左), right(向右), up(向上), down(向下), leftup(左上), rightup(右上), leftdown(左下), rightdown(右下), zoomin(放大), zoomout(缩小),stop(停止PTZ操作)  
speed | 是 | int | 调节速度(1~10, 默认位5)  
chId | 否 | string | 如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID  
  
# **响应参数**

200

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/ptz \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"cmd":"left",
    	"speed":1
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控变焦控制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 >
[PTZ相关接口](https://developer.qiniu.com/qvs/api/7289/ptz-related-interface) >
变焦控制

#  变焦控制

最近更新时间: 2022-11-28 16:22:26

本接口用于摄像头的变焦控制

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/devices/{deviceId}/focus`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
deviceId | 是 | string | 设备ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
cmd | 是 | string | focusnear(焦距变近), focusfar(焦距变远),stop(停止)  
speed | 是 | int | 调节速度(1~10, 默认位5)  
chId | 否 | string | 如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID  
  
# **响应参数**

200  
**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/focus \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"cmd":"focusfar",
    	"speed":1
    }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

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