调用CreateUploadAttachedMedia获取辅助媒资上传地址和凭证,辅助媒资包括水印、字幕文件等。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateUploadAttachedMedia

系统规定参数。取值:CreateUploadAttachedMedia

Title String 测试

标题。规则:

  • 长度不超过128个字节。
  • UTF8编码。
BusinessType String watermark

业务类型。取值:

  • watermark:水印。
  • subtitle:字幕。
  • material:素材。
MediaExt String png

文件扩展名。取值:

  • 水印:png、gif、apng、mov
  • 字幕:srt、ass、stl、ttml、vtt
  • 素材:jpg、gif、png、mp4、mat、zip
FileName String D:\test.png

源文件名。

FileSize String 123

文件大小。单位:字节。

Tags String tag1,tag2

标签。规则:

  • 单个标签不超过32字节。最多不超过16个标签。
  • 多个标签,请使用英文逗号(,)分隔。
  • UTF-8编码。
StorageLocation String outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com

存储地址。

当不为空时,会使用该指定的存储地址上传辅助媒资文件。登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理查看存储地址。

Description String uploadTest

媒资描述。规则:

  • 长度不超过1024个字节。
  • UTF-8编码。
UserData String {"MessageCallback":{"CallbackURL":"http://test.test.com"},"Extend":{"localId":"xxx","test":"www"}}

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

说明
  • 此参数中消息回调的使用前提是需要在控制台配置HTTP回调地址和勾选对应的回调事件类型才能使用,否则回调设置不生效。

  • 上传加速功能在使用前请您提交工单开通,更多信息,请参见上传相关说明

CateIds String 12984346,08130876

分类ID。

  • 多个ID,请使用英文逗号(,)分隔。最多支持5个。
  • 登录点播控制台,选择配置管理 > 媒资管理配置 > 分类管理编辑或查看分类的ID。
AppId String app-****

应用ID。默认取值:app-1000000。使用信息,请参见多应用

返回数据

名称 类型 示例值 描述
FileURL String https://sample.oss-cn-shanghai.aliyuncs.com/watermark/****.mov

文件OSS地址(不带鉴权)。添加水印时该地址可做为添加水印接口的入参FileUrl。

RequestId String 73254DE5-F260-47*****20-D06856B63C01

请求ID。

UploadAddress String LWNuLXNoYW5*****naGFpLmFsaXl1b

上传地址。

MediaId String 97dc17a5a*****bc3668489b84ce9

媒资ID。

MediaURL String http://sample.com/watermark/****.mov?auth_key=****

媒资地址。如果配置了CDN域名则返回CDN地址,否则为OSS地址。

UploadAuth String UzFnUjFxNkZ0NUI*****ZTaklyNWJoQ00zdHF

上传凭证。

说明
  • 该接口不会真正上传辅助媒资文件,您需要在获取上传地址和凭证后,对其进行Base64解码,再调用OSS SDK将辅助媒资上传至指定的bucket中(和视频、图片上传相同)。
  • 如果上传凭证失效(有效期3000秒),请重新调用此接口获取上传地址和凭证。
  • 如果返回的MediaURL在浏览器无法访问(403),是因为您开启了点播域名的鉴权功能。可关闭URL鉴权或自助生成鉴权签名
  • 更多使用说明,请参见上传地址和凭证

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=CreateUploadAttachedMedia
&BusinessType=watermark
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateUploadAttachedMediaResponse>
	<RequestId>73254DE5-F260-47*****20-D06856B63C01</RequestId>
	<MediaId>97dc17a5a*****bc3668489b84ce9</MediaId>
	<UploadAddress>LWNuLXNoYW5*****naGFpLmFsaXl1b</UploadAddress>
	<UploadAuth>UzFnUjFxNkZ0NUI*****ZTaklyNWJoQ00zdHF</UploadAuth>
	<FileURL>https://sample.oss-cn-shanghai.aliyuncs.com/watermark/****.mov</FileURL>
	<MediaURL>http://sample.com/watermark/****.mov?auth_key=****</MediaURL>
</CreateUploadAttachedMediaResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "73254DE5-F260-47*****20-D06856B63C01",
  "MediaId" : "97dc17a5a*****bc3668489b84ce9",
  "UploadAddress" : "LWNuLXNoYW5*****naGFpLmFsaXl1b",
  "UploadAuth" : "UzFnUjFxNkZ0NUI*****ZTaklyNWJoQ00zdHF",
  "FileURL" : "https://sample.oss-cn-shanghai.aliyuncs.com/watermark/****.mov",
  "MediaURL" : "http://sample.com/watermark/****.mov?auth_key=****"
}

错误码

访问错误中心查看更多错误码。

SDK示例

建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: