全部產品
Search

搜尋本產品

    Intelligent Media Services：CreateUploadStream - 擷取媒體流上傳地址和憑證

    文件中心

    Intelligent Media Services：CreateUploadStream - 擷取媒體流上傳地址和憑證

    更新時間：Mar 21, 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****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。