首页 智能媒体服务 API参考指南 API目录 媒体上传 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***"
}

错误码

访问错误中心查看更多错误码。
阿里云首页 智能媒体服务 相关技术圈