全部产品
Search

搜索本产品

    智能媒体服务：CreateUploadStream - 获取媒体流上传地址和凭证

    文档中心

    智能媒体服务：CreateUploadStream - 获取媒体流上传地址和凭证

    更新时间：Aug 27, 2026

    获取媒体流上传地址和凭证，并将上传完成的媒体流挂载到指定的MediaId下。

    接口说明

    适用场景

    本接口用于本地上传媒体流

    使用限制

    • 本接口仅支持上传至 VOD 点播存储，不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户，可以先通过OSS SDK上传文件至 OSS，再调用 RegisterMediaStream 接口将媒体流挂载到指定媒资。

    • 本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）地域。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ice:CreateUploadStream

    create

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    MediaId

    string

    否

    媒资 ID。

    ****20b48fb04483915d4f2cd8ac****
    Definition

    string

    否

    视频流清晰度定义。取值：

    • FD：流畅。

    • LD：标清。

    • SD：高清。

    • HD：超清

    • OD：原画。

    • 2K：2K。

    • 4K：4K。

    • SQ：普通音质。

    • HQ：高音质。

    HD
    FileExtension

    string

    否

    媒体文件扩展名。

    MP4
    HDRType

    string

    否

    转码流 HDR 类型。取值：

    • HDR

    • HDR10

    • HLG

    • DolbyVision

    • HDRVivid

    • SDR+

    说明

    • 大小写不敏感。

    • 非 HDR 视频该参数为空即可。

    HDR10
    UserData

    string

    否

    用户自定义参数。

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

    返回参数

    名称

    类型

    描述

    示例值

    object

    返回结果。

    RequestId

    string

    请求 ID。

    ******11-DB8D-4A9A-875B-275798******
    MediaId

    string

    媒资 ID。

    ****c469e944b5a856828dc2****
    FileURL

    string

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

    http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
    UploadAddress

    string

    上传地址。

    说明

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

    eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    UploadAuth

    string

    上传凭证。

    说明

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

    eyJFbmRwb2ludCI6Imm****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaId": "****c469e944b5a856828dc2****",
  "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    错误码

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

    变更历史

    更多信息，参考变更详情。