全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
视频点播

获取视频上传地址和凭证

更新时间:2018-01-23 11:43:23

描述

获取视频上传地址和凭证,并创建视频信息。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值: CreateUploadVideo
Title String 视频标题,长度不超过128个字节,UTF8编码
FileName String 视频源文件名,必须带扩展名,且扩展名不区分大小写, 支持的扩展名参见上传概述的限制部分
FileSize String 视频文件大小,单位:字节
Description String 视频描述,长度不超过1024个字节,UTF8编码
CoverURL String 自定义视频封面URL地址
CateId Long 视频分类ID,请在“点播控制台-全局设置-分类管理”里编辑或查看分类的ID
Tags String 视频标签,单个标签不超过32字节,最多不超过16个标签。多个用逗号分隔,UTF8编码
TemplateGroupId String 转码模板组ID,当不为空时,会使用该指定的模板组进行转码。可在控制台转码设置里查看模版组ID。

请注意:
1. 输入参数(如Title、Description、Tags等)不能包含表情符。
2. 为确保正常播放,“不转码即分发”模板组仅支持mp4、flv和m3u8格式的视频(关注FileName的扩展名);若使用阿里云播放器,版本须为3.1.0或以上。
3. 指定不转码的模板组,视频上传后仅有上传完成的事件通知,不会有转码完成事件。

返回参数

名称 类型 描述
RequestId String 请求ID
VideoId String 视频ID
UploadAddress String 上传地址
UploadAuth String 上传凭证

请注意:
1. 该接口不会真正上传视频文件,您需要拿到上传凭证和地址后使用上传SDK进行文件上传;
2. 如果视频上传凭证失效(有效期3000秒),请调用刷新视频上传凭证接口重新获取上传凭证。

特殊错误码

错误代码 错误描述 HTTP状态码 语义
InvalidParameter.FileName The specified parameter FileName is not valid. 400 参数FileName无效
Forbidden.InitFailed Initialization of your account has failed while opening service. 403 服务开通时账号初始化失败
AddVideoFailed Adding video has failed due to some unknown error. 503 创建视频信息失败,请稍后重试
InvalidTemplateGroupId.NotFound The TemplateGroupId does not exist. 404 指定的模板组ID不存在

示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=CreateUploadVideo&Title=exampleTitle&FileName=example.avi&FileSize=10485760&Format=JSON&<公共参数>

注:示例中的“公共参数”需要有效传参,详情请查看 公共参数说明文档

返回示例

Json:

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  4. "UploadAddress": "eyJTZWN1cml0eVRva2VuIjoiQ0FJU3p3TjF",
  5. "UploadAuth": "eyJFbmRwb2ludCI6Im"
  6. }
本文导读目录