使用须知

前提条件

了解以下内容可以帮助您更好地使用API操作VCR服务:

  • 使用API 开发前,建议您了解VCR核心概念

  • AK/SK

    用户可以通过两种方式与百度智能云进行交互,包括认证方式和匿名方式。对于认证方式,需要通过使用Access Key Id / Secret Access Key加密的方法来验证某个请求的发送者身份。Access Key Id(AK)用于标示用户,Secret Access Key(SK)是用户用于加密认证字符串和百度智能云用来验证认证字符串的密钥,其中SK必须保密,只有用户和百度智能云知道。

  • API认证机制

    当百度智能云接收到用户的请求后,系统将使用相同的SK和同样的认证机制生成认证字符串,并与用户请求中包含的认证字符串进行比对。如果认证字符串相同,系统认为用户拥有指定的操作权限,并执行相关操作;如果认证字符串不同,系统将忽略该操作并返回错误码。

  • VOD API文档

  • BOS API文档

系统限制

视频审核要求

  1. 入审视频时长不超过3个小时。
  2. 入审视频分辨率大于等于15 x 15。
  3. 入审视频audio、video 至少存在一个,不能为空。

编码风格

所有 HTTP API 均为 REST 风格。

日期与时间

日期与时间的表示有多种方式。为统一起见,除非约定俗成或有相应规范,凡是HTTP标准中规定的表示日期和时间字段用GMT,其他日期时间表示的地方一律采用UTC时间,遵循ISO 8601,并做以下约束:

  • 表示时间一律采用hh:mm:ss方式,并在最后加一个大写字母Z表示UTC时间。例如23:00:10Z表示UTC时间23点0分10秒。
  • 凡涉及日期和时间合并表示时,在两者中间加大写字母T,例如2014-06-01T23:00:10Z表示UTC时间2014年6月1日23点0分10秒。

排版约定

排版格式 含义
< > 变量
[ ] 可选项
{ } 必选项
¦ 互斥关系
等宽字体Courier New 屏幕输出