全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
视频点播

获取视频上传地址和凭证

更新时间:2018-03-09 15:25:03

描述

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

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:CreateUploadVideo
TitleString视频标题。
  • 长度不超过128个字节。
  • UTF8编码。
FileNameString视频源文件名。
  • 必须带扩展名,且扩展名不区分大小写。
  • 支持的扩展名参见 上传概述 的限制部分。
FileSizeString视频文件大小,单位:字节。
DescriptionString视频描述。
  • 长度不超过1024个字节。
  • UTF8编码。
CoverURLString 自定义视频封面URL地址。
CateIdLong视频分类ID。
请在 点播控制台 > 全局设置 > 分类管理 中编辑或查看分类的ID。
Tags String视频标签。
  • 单个标签不超过32字节,最多不超过16个标签。
  • 多个用逗号分隔。
  • UTF8编码。
TemplateGroupIdString转码模板组ID。
当不为空时,会使用该指定的模板组进行转码。可在 点播控制台 > 转码设置 里查看模版组ID。

注意:

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

返回参数

名称类型描述
RequestIdString请求ID。
VideoIdString 视频ID。
UploadAddressString上传地址。
UploadAuthString上传凭证。

注意:

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

错误码

下面的表格只列举了本接口特有的错误码,视频点播通用的错误码信息,参见 错误码列表

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

示例

请求示例

  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. }
本文导读目录