CreateUploadMedia - 获取媒资上传地址和凭证

调用CreateUploadMedia获取媒资上传地址和凭证,并创建媒资信息。

接口说明

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

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AppIdstring

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

app-1000000
EntityIdstring

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

9e177cac2fb44f8b8c67b199fcc7bffd
FileInfostring

文件信息,json字符串。 Type

文件类型(必填),取值:

  • video、image、audio、text、other

Name 文件名(必填):

  • 不带扩展名。

Size 文件大小(选填)。

Type 文件扩展名(必填)。

{\"Type\":\"video\",\"Name\":\"test.mp4\",\"Size\":108078336,\"Ext\":\"mp4\"}
UserDatastring

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

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

目标存储地址。

StorageType 仅支持OSS。

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

上传媒资的元数据,JSON格式。

Title 标题(必填):

  • 长度不超过128个字符。
  • UTF-8编码。

Description 描述(选填):

  • 长度不超过1024个字符。
  • UTF-8编码。

CateId 分类ID(选填)。

Tags 标签(选填)。

BusinessType 业务类型(必填),取值:

  • Type = video ,取值:

opening: 片头/开场;ending: 片尾

  • Type = image ,取值: default:默认; cover:封面
  • Type = text ,取值: subtitles:字幕; font:字体;
  • Type=material ,取值: watermark:水印;
  • general 通用;

CoverURL 封面(选填)。

DynamicMetaData 动态元数据,类型为字符串。

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

Type = video || audio 有上传后处理动作。

ProcessType取值:Workflow。

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

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求ID。

4E84BE44-58A7-****-****-FBEBEA16EF94
MediaIdstring

媒资ID。

****20b48fb04483915d4f2cd8ac****
MediaURLstring

媒资地址。

说明如果配置了CDN域名则返回CDN地址,否则为OSS地址。说明如果返回的MediaURL在浏览器无法访问(403),是因为您开启了点播域名的鉴权功能。可关闭URL鉴权或自助生成鉴权签名。
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

上传地址。

说明接口返回的上传地址是Base64加密后的值。调用SDK或API完成媒资上传时需要对其进行Base64解码后再使用。仅OSS原生SDK或OSS API方式上传需要自行解析UploadAddress。
eyJFbmRwb2ludCI6Imh0dHBzOi8vb3NzLWNuLXNoYW5naGFpLmFsaXl1bmNzLmNvbSIsIkJ1Y2tldCI6InN6aGQtdmlkZW8iLCJGaWxlTmFtZSI6InZvZC0yOTYzMWEvc3YvNTBmYTJlODQtMTgxMjdhZGRiMTcvNTBmYTJlODQtMTgxMjdhZGRiM***
UploadAuthstring

上传凭证。

说明接口返回的上传凭证是Base64加密后的值。调用SDK或API完成媒资上传时需要对其进行Base64解码后再使用。仅OSS原生SDK或OSS API方式上传需要自行解析UploadAuth。
eyJBY2Nlc3NLZXlJZCI6IkxUQUk0Rm53bTk1dHdxQjMxR3IzSE5hRCIsIkFjY2Vzc0tleVNlY3JldCI6Ik9lWllKR0dTMTlkNkZaM1E3UVpJQmdmSVdnM3BPaiIsIkV4cGlyYXRpb24iOiI***

示例

正常返回示例

JSON格式

{
  "RequestId": "4E84BE44-58A7-****-****-FBEBEA16EF94",
  "MediaId": "****20b48fb04483915d4f2cd8ac****",
  "MediaURL": "https://xxq-live-playback.oss-cn-shanghai.aliyuncs.com/capture/5d96d2b4-111b-4e5d-a0e5-20f44405bb55.mp4",
  "FileURL": "http://outin-***.oss-cn-north-2-gov-1.aliyuncs.com/sv/40360f05-181f63c3110-0004-cd8e-27f-de3c9.mp4",
  "UploadAddress": "eyJFbmRwb2ludCI6Imh0dHBzOi8vb3NzLWNuLXNoYW5naGFpLmFsaXl1bmNzLmNvbSIsIkJ1Y2tldCI6InN6aGQtdmlkZW8iLCJGaWxlTmFtZSI6InZvZC0yOTYzMWEvc3YvNTBmYTJlODQtMTgxMjdhZGRiMTcvNTBmYTJlODQtMTgxMjdhZGRiM***",
  "UploadAuth": "eyJBY2Nlc3NLZXlJZCI6IkxUQUk0Rm53bTk1dHdxQjMxR3IzSE5hRCIsIkFjY2Vzc0tleVNlY3JldCI6Ik9lWllKR0dTMTlkNkZaM1E3UVpJQmdmSVdnM3BPaiIsIkV4cGlyYXRpb24iOiI***"
}

错误码

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

阿里云首页 智能媒体生产 相关技术圈