API服务域名

MCA 为全局服务，域名为：

Region	Endpoint	Protocol
全局	vca.bj.baidubce.com	HTTP and HTTPS

详细了解请参考多区域选择。

说明：

MCA API支持HTTP和HTTPS两种调用方式。为了提升数据的安全性，建议通过HTTPS调用。 如果您是初次调用百度智能云产品的API，可以观看API入门视频指南，快速掌握调用API的方法。也可以通过可视化API调试工具，进行学习与调用测试。

公共头

公共请求头

公共头域	描述	是否必要
host	请求host。	是
authorization	包含 Access Key 与请求签名	是
content-type	application/json; charset=utf-8	是
content-length	上传 Object 的大小，以字节为单位	否

MCA API要求使用JSON格式的结构体来描述一个请求的具体内容。

公共响应头

公共头部	描述
Content-Type	application/json; charset=utf-8。
x-bce-request-id	MCA后端生成，并自动设置到响应头域中。

MCA 的API服务采用JSON格式的消息体作为响应返回的格式。

签名认证访问

百度智能云采用统一的API鉴权认证机制，通过使用Access Key Id / Secret Access Key加密的方法来验证某个请求的发送者身份，详情请见鉴权认证机制。Access Key Id（AK）用于标示用户，Secret Access Key（SK）是用户用于加密认证字符串和百度智能云用来验证认证字符串的密钥，其中SK必须保密，只有用户和百度智能云知道。

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

MCA SDK中封装了鉴权实现，建议直接使用。

系统限制

使用API 开发前，建议您了解MCA核心概念。

视频要求

1. 时长6小时以内；
2. 分辨率需大于等于30x30。

编码风格

所有 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秒。