CreateUploadMedia
本接口支持获取音视频、图片和辅助媒资的上传地址和凭证。并创建媒资信息
服务地址：
华东1（杭州）
输入参数
只看必填
AppId应用ID
EntityId实体 ID
FileInfo文件信息
UserData自定义设置
UploadTargetConfig目标存储地址
MediaMetaData上传媒资的元数据
PostProcessConfigType = video || au...
插件下载了解更多
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.
安 装

接口说明

  • 获取上传地址和凭证为智能媒体服务的核心基础，是每个上传操作的必经过程。
  • 如果视频上传凭证失效（默认有效期为 3000 秒），请调用刷新视频上传凭证接口重新获取上传凭证。
  • 上传后，可通过配置回调，接收上传事件通知或调用 GetMediaInfo 接口根据返回的媒资状态来判断是否上传成功。
  • 本接口返回的 MediaId 参数，可以用于媒资生命周期管理或媒体处理。

使用限制

  • 本接口仅支持上传至 VOD 点播存储，不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户，可以先通过OSS SDK上传文件至 OSS，再调用 RegisterMediaInfo 接口将 OSS 文件注册至媒资库。
  • 本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）地域。

请求参数

字段名称字段详情
AppIdstring

应用 ID。默认取值：app-1000000。

示例值:app-1000000
EntityIdstring

实体 ID。可调用 CreateEntity 接口创建实体，自定义动态元数据结构。

示例值:9e177cac2fb44f8b8c67b199fcc7bffd
FileInfostring

文件信息，JSON 类型，包含参数字段：展开详情

示例值:{\"Type\":\"video\",\"Name\":\"test\",\"Size\":108078336,\"Ext\":\"mp4\"}参考取值来源:
    GetMediaInfo
    BatchGetMediaInfos
    ListMediaBasicInfos
UserDatastring

自定义设置。为 JSON 字符串，支持消息回调等设置。

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

目标存储地址。展开详情

示例值:{\"StorageType\":\"oss\",\"StorageLocation\":\"outin-***.oss-cn-shanghai.aliyuncs.com\"}
MediaMetaDatastring

上传媒资的元数据，JSON 格式。展开详情

示例值:{\"Title\": \"UploadTest\", \"Description\": \"UploadImageTest\", \"Tags\": \"tag1,tag2\",\"BusinessType\":\"cover\"}
PostProcessConfigstring

Type = video || audio 有上传后处理动作。展开详情

示例值:{\"ProcessType\":\"Workflow\",\"ProcessID\":\"74ba870f1a4873a3ba238e0bf6fa9***\"}

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:4E84BE44-58A7-****-****-FBEBEA16EF94
MediaIdstring

媒资 ID。

示例值:****20b48fb04483915d4f2cd8ac****
MediaURLstring

媒资地址。展开详情

示例值:https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4
FileURLstring

文件 OSS 地址（不带鉴权）。

示例值:http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4
UploadAddressstring

上传地址。展开详情

示例值:eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuthstring

上传凭证。展开详情

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