CreateUploadVideo
点播服务下发上传地址和凭证以保障授权和安全，防止恶意上传，并在下发时自动创建媒体ID（MediaId），也叫视频ID（VideoId）用于管理。通过调用本接口可获取上传所需地址和凭证，并创建音视频信息
服务地址：
华东2（上海）
输入参数
只看必填
CoverURL自定义视频封面的URL地址
Description上传完成后
FileName待上传的音/视频源文件地址
FileSize待上传的音/视频源文件的大小
Title上传完成后
CateId分类ID
Tags音/视频标签
UserData自定义设置
TemplateGroupId转码模板组ID
WorkflowId工作流ID
StorageLocation存储地址
AppId应用ID
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 请确保在使用该接口前，已充分了解视频点播产品的收费方式和价格。媒资文件上传到视频点播中会产生存储费用，计费详情，请参见媒资存储计费。如果您已开通了存储传输加速，则上传媒资文件到视频点播时还将涉及上传加速费用，计费详情请参见存储传输加速计费。存储费用从文件上传成功开始计算，加速费用在开通后进行上传操作时进行计算，仅调用本接口不计费。
  • 获取上传地址和凭证为点播服务的核心基础，是每个上传操作的必经过程。点播服务提供多种不同的上传方式，每种方式对获取上传地址和凭证的要求不同，详细内容请参见上传地址和凭证的使用说明。
  • 本接口仅用于获取上传地址和凭证以及创建媒资基础信息，并非上传文件，通过接口上传的完整示例，请参见通过视频点播 API 上传媒资文件。
  • 本接口既支持获取视频的上传地址和凭证，同时也支持获取音频的上传地址和凭证。具体操作，请参见上传地址和凭证。
  • 如果视频上传凭证失效（默认有效期为 3000 秒），请调用 RefreshUploadVideo 接口重新获取上传凭证。
  • 上传后，可通过配置回调，接收上传事件通知或调用 GetMezzanineInfo 接口根据返回的文件状态来判断是否上传成功。
  • 本接口返回的 VideoId 参数，可以用于媒资生命周期管理或媒体处理。

请求参数

字段名称字段详情
CoverURLstring

自定义视频封面的 URL 地址。

示例值:https://example.aliyundoc.com/image/D22F553TEST****.jpeg参考取值来源:
    ListLiveRecordVideo
Descriptionstring

上传完成后，在点播中展示的音/视频描述。展开详情

示例值:UploadTest
FileNamestring

待上传的音/视频源文件地址。展开详情

示例值:D:\video_01.mp4
FileSizeinteger<int64>

待上传的音/视频源文件的大小。单位：字节。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:123
Titlestring

上传完成后，在点播中展示的音/视频标题。展开详情

示例值:UploadTest
CateIdinteger<int64>

分类 ID。可通过以下方式获取：展开详情

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:100036****参考取值来源:
    AddCategory
    GetCategories
Tagsstring

音/视频标签。展开详情

示例值:tag1,tag2
UserDatastring

自定义设置。为 JSON 字符串，支持消息回调、上传加速等设置。更多信息，请参见 UserData 。展开详情

示例值:{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
TemplateGroupIdstring

转码模板组 ID。可通过以下方式获取：展开详情

示例值:405477f9e214d19ea2c7c854****参考取值来源:
    AddTranscodeTemplateGroup
    ListTranscodeTemplateGroup
    UpdateTranscodeTemplateGroup
WorkflowIdstring

工作流 ID。可登录点播控制台，选择配置管理 > 媒体处理配置 > 工作流管理查看工作流 ID。展开详情

示例值:613efff3887ec34af685714cc461****
StorageLocationstring

存储地址。可通过以下方式获取：展开详情

示例值:out-****.oss-cn-shanghai.aliyuncs.com参考取值来源:
    AddVodStorageForApp
AppIdstring

应用 ID。默认取值：app-1000000。更多信息，请参见多应用。

示例值:app-1000000参考取值来源:
    ListAppInfo
    CreateAppInfo

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:25818875-5F78-4AF6-04D5-D7393642****
UploadAddressstring

上传地址。展开详情

示例值:eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
VideoIdstring

音/视频 ID。可作为媒资管理、媒体处理、媒体审核等接口的请求参数。

示例值:93ab850b4f6f54b6e91d24d81d44****
UploadAuthstring

上传凭证。展开详情

示例值:eyJFbmRwb2ludCI6Imm****
变更历史
暂无变更历史