调用CreateUploadVideo获取视频上传地址和凭证,并创建视频信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateUploadVideo |
系统规定参数。取值:CreateUploadVideo。 |
FileName | String | 是 | D:\****.mp4 |
视频源文件名。
|
Title | String | 是 | UploadTest |
视频标题。
|
CoverURL | String | 否 | https://*****test.cn/image/D22F553*****TEST.jpeg |
自定义视频封面的URL地址。 |
Description | String | 否 | UploadTest |
视频描述。
|
FileSize | Long | 否 | 123 |
视频文件大小。单位:字节。 |
CateId | Long | 否 | 6771111 |
视频分类ID。 登录点播控制台,选择配置管理 > 媒资管理配置 > 分类管理编辑或查看分类的ID。 |
Tags | String | 否 | tag1,tag2 |
视频标签。
|
UserData | String | 否 | {"MessageCallback":"{"CallbackURL":"http://test.test.com"}", "Extend":"{"localId":"*****", "test":"www"}"} |
自定义设置。为JSON字符串,支持消息回调、上传加速等设置。更多信息,请参见UserData。 |
TemplateGroupId | String | 否 | 405477f9e21*****d19ea2c7c854 |
转码模板组ID。 说明 当不为空时,会使用该指定的模板组进行转码。登录点播控制台,选择配置管理 > 媒体处理配置 > 转码模板组查看模版组ID。
|
WorkflowId | String | 否 | 405477f9e21*****d19ea2c7c854 |
工作流ID。 说明 如果同时传递了WorkflowId和TemplateGroupId,以WorkflowId为准。使用说明,请参见工作流。
|
StorageLocation | String | 否 | out-****.oss-cn-shanghai.aliyuncs.com |
存储地址。 当不为空时,会使用该指定的存储地址上传视频文件。登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理查看存储地址。 |
AppId | String | 否 | app-**** |
应用ID。默认取值:app-1000000。更多信息,请参见多应用。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4A*****F6-D7393642CA58 |
请求ID。 |
VideoId | String | 93ab850b4f6f*****54b6e91d24d81d4 |
视频ID。 |
UploadAddress | String | eyJTZWN1cml0*****a2VuIjoiQ0FJU3p3TjF |
上传地址。 |
UploadAuth | String | eyJFbmRw*****b2ludCI6Im |
上传凭证。 |
- 该接口不会真正上传视频文件,您需要获得上传地址和凭证后,对其进行Base64解码,再调用OSS SDK将视频文件上传至指定的bucket中。详细操作,请参见基于OSS原生SDK上传视频到点播。
- 如果视频上传凭证失效(有效期为3000秒),请调用刷新视频上传凭证接口重新获取上传凭证。
示例
请求示例
https://vod.aliyuncs.com]/?Action=CreateUploadVideo
&FileName=D:\****.mp4
&Title=UploadTest
&<公共请求参数>
正常返回示例
XML
格式
<CreateUploadVideoResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<VideoId>93ab850b4f6f*****54b6e91d24d81d4</VideoId>
<UploadAddress>eyJTZWN1cml0*****a2VuIjoiQ0FJU3p3TjF</UploadAddress>
<UploadAuth>eyJFbmRw*****b2ludCI6Im</UploadAuth>
</CreateUploadVideoResponse>
JSON
格式
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"VideoId": "93ab850b4f6f*****54b6e91d24d81d4",
"UploadAddress": "eyJTZWN1cml0*****a2VuIjoiQ0FJU3p3TjF",
"UploadAuth": "eyJFbmRw*****b2ludCI6Im"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
InvalidFileName.Extension |
The specified FileName’s extension is illegal. |
400 |
参数FileName的文件扩展名无效。点播支持的文件扩展名限制,请参见上传概述。 |
IllegalCharacters |
The specified $Parameter contains illegal emoticon or special characters. |
400 |
请求参数Parameter(如:Title、Description、Tags等)参数值中不能包含表情符。 |
LengthExceededMax |
The specified $Parameter length has exceeded $MaxLength bytes. |
400 |
请求参数Parameter(如:Title、Description、Tags)参数值长度超过MaxLength限制。参数值长度限制请参考本文档中请求参数说明。 |
TagsExceededMax |
The specified Tags count has exceeded 16. |
400 |
设置的标签个数超过最多16个的限制。 |
InvalidTemplateGroupId.NotFound |
The TemplateGroupId does not exist. |
404 |
指定的模板组ID不存在。 |
InvalidStorage.NotFound |
The StorageLocation does not exist. |
404 |
设置的存储地址不存在,登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理 里查看确认。 |
Forbidden.InitFailed |
Initialization of your account has failed while opening service. |
403 |
服务开通时账号初始化失败。 |
AddVideoFailed |
Adding video has failed due to some unknown error. |
503 |
创建视频信息失败,请稍后重试。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见:
在文档使用中是否遇到以下问题
更多建议
匿名提交