日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 媒體處理 開發參考 API參考指南 API目錄 媒體接口 AddMedia - 新增媒體

AddMedia - 新增媒體

更新時間：
產品詳情
我的收藏

提交新增媒體作業。

接口說明

  • 當在 OSS 上有存量視頻時，可以通過此接口處理存量視頻，從而避免重新上傳視頻到 OSS。如果已經配置過工作流，上傳媒體文件到 OSS 后，OSS 會自動通知 MPS。根據設置的 OSS Bucket，Object 自動匹配處于激活狀態的工作流自動執行，因此通常情況下不需要手動調用 AddMedia 接口處理文件。
  • 只有指定激活狀態的工作流處理媒體文件時，才會自動獲取媒體信息；不指定工作流或指定其他狀態的工作流時，不會獲取媒體信息。

QPS 限制

本接口的單用戶 QPS 限制為 100 次/秒。超過限制，API 調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見 QPS 限制。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
mts:AddMediacreate
  • 全部資源
    *
    無
無

請求參數

名稱類型必填描述示例值
FileURLstring是

輸入文件的路徑，可以通過 MPS 或 OSS 控制臺獲取。詳細觸發規則請參見下文中工作流觸發匹配規則。

  • 僅支持 OSS HTTP 地址，不支持 CDN 地址和 HTTPS 地址。
  • 不超過 3200 字節。
  • URL 遵循 RFC 2396（UTF-8 編碼，并進行 URLEncode）。更多信息，請參見 URLEncode 說明。
http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
Titlestring否

媒體標題。

  • 長度限制不超過 128 個字節。
  • UTF-8 編碼。
mytest
Descriptionstring否

描述。

  • 長度限制不超過 1024 個字節。
  • UTF-8 編碼。
A test video
CoverURLstring否

封面 URL。即您需要設置的封面的存儲地址，可以通過 MPS 控制臺 > 工作流管理 > 媒體 Bucket或OSS 控制臺 > 我的訪問路徑獲取。

  • 不超過 3200 字節。
  • URL 遵循 RFC 2396（UTF-8 編碼，并進行 URLEncode）。更多信息，請參見 URLEncode 說明。
http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
Tagsstring否

標簽列表。

說明 媒體處理中，每個媒體的每個標簽都是獨立的，可以通過搜索媒體庫來查找所有設置了相同標簽的媒體。

  • 用半角逗號（,）分隔，不超過 16 個標簽。

  • 單個標簽不能超過 32 個字節。

  • UTF-8 編碼。

tag1,tag2
MediaWorkflowIdstring否

媒體工作流 ID。可通過 MPS 控制臺或新增媒體工作流接口獲取。

07da6c65da7f458997336e0de192****
MediaWorkflowUserDatastring否

媒體工作流用戶自定義數據。

  • 不超過 1024 字節。
  • UTF-8 編碼。
test
InputUnbindboolean否

是否檢查指定的工作流支持輸入路徑。此處建議您選擇檢查（true），避免因路徑出錯而導致的錯誤。取值：

  • true：檢查

  • false：不檢查

false
CateIdlong否

媒體所屬類目 ID。不允許為負數。

123
OverrideParamsstring否

覆蓋參數。

  • 示例 1：HLS 打包字幕覆蓋{“WebVTTSubtitleOverrides”,[{“RefActivityName”:”subtitleNode”,”WebVTTSubtitleURL”:”http://test.oss-cn-hangzhou.aliyuncs.com/example1.vtt"}]}。
  • 示例 2：DASH 打包字幕覆蓋 {“subtitleTransNodeName”:{“InputConfig”:{“Format”:”stl”,”InputFile”:{“URL”:”http://subtitleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}。
{“subtitleTransNodeName”:{“InputConfig”:{“Format”:”stl”,”InputFile”:{“URL”:”http://exampleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}

工作流觸發匹配規則

規則匹配執行策略如下：以新增文件的路徑為基礎，檢查工作流綁定的位置，如果新增文件的路徑中包含規則綁定的字符串則匹配，不包含則不匹配。例如：http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv規則：

1、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/          匹配
2、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/            匹配
3、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/              匹配
4、http://bucket.oss-cn-hangzhou.aliyuncs.com/                匹配
5、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv  匹配
6、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/         不匹配
7、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/           不匹配
8、http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/         不匹配
說明 在新增媒體工作流時，請您不要配置一個工作流的輸入路徑為另外一個工作流的輸入路徑的前綴，否則會一個增量文件觸發兩次工作流執行實例。例如：兩個工作流的輸入路徑分別配置 test 和 test1，則當輸入文件上傳到 test1 文件夾下同樣滿足 test 前綴，因此會觸發兩次工作流執行實例。

匹配文件擴展名

觸發要求必須是多媒體文件，媒體庫服務是通過文件擴展名來判斷的。文件或者沒有擴展名（文件名中不包含擴展名分割符號“.”），或者擴展名符合下面的規則：

說明 對于 swf，截圖及轉碼服務質量不保障。
類型擴展名
視頻3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
音頻aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

媒體工作流消息

媒體工作流采用 阿里云輕量消息隊列（原 MNS） 發送消息給視頻云服務接入方，媒體工作流會在（Start/Report）活動節點完成時發送消息，若需要接收消息，需要在 Start 活動上設置隊列/通知名稱，媒體工作流產生的消息存儲在隊列/通知中，可以使用 輕量消息隊列（原 MNS） SDK 獲取消息，消息規格如下：

名稱類型描述
RunIdString工作流執行 ID。
NameString活動名稱。
TypeString活動類型。范圍：Report、Start
StateString活動狀態。范圍：Fail、Success
CodeString錯誤碼。如果活動狀態是 Fail 時，會給出具體的錯誤碼。
MessageString錯誤消息。如果活動狀態是 Fail 時，會給出詳細的錯誤描述信息。
MediaWorkflowExecutionMediaWorkflowExecution媒體工作流執行信息。

返回參數

名稱類型描述示例值
object

返回參數。

RequestIdstring

請求 ID。

05F8B913-E9F3-4A6F-9922-48CADA0FFAAD
Mediaobject

媒體信息。

CreationTimestring

創建時間。

2016-09-20T03:02:40Z
CateIdlong

類目 ID。

1
Heightstring

媒體文件高度。

1280
CensorStatestring

視頻審核狀態。取值：

  • Initiated：初始（上傳成功審核未完成）。

  • Pass：通過（上傳成功審核已通過）。

Initiated
Tagsarray

標簽。

Tagstring

標簽列表。

tag,tag2
Bitratestring

碼率。

1148.77
MediaIdstring

媒體 ID。

3e6149d5a8c944c09b1a8d2dc3e4****
Fileobject

原文件。

Statestring

文件狀態。此處默認為 Normal（正常）。

Normal
URLstring

文件 URL。

http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
PublishStatestring

媒體發布狀態，表示是否對外發布媒體。取值：

  • Initiated：初始。
  • UnPublish：未發布，OSS 播放文件權限為 Private。
  • Published：已發布，OSS 播放文件權限為 Default。
Published
Descriptionstring

描述。長度不超過 1024 個字節。

A test video
Widthstring

媒體文件寬度。

1280
Sizestring

媒體文件大小。

379860
CoverURLstring

封面 URL。

http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
RunIdListarray

媒體工作流執行實例 ID 列表。

RunIdstring

已執行的媒體工作流執行實例 ID 列表，半角逗號（,）分隔。

{"RunId":["cbad98d35629470fa05ff393d347****"]}
Durationstring

媒體文件時長。

2.645333
Fpsstring

媒體文件幀率。

25.0
Titlestring

媒體標題。長度不超過 128 個字節。

mytest.mp4
Formatstring

格式。支持 mov，mp4，m4a，3gp，3g2，mj2。

mp4

示例

正常返回示例

JSON格式

{
  "RequestId": "05F8B913-E9F3-4A6F-9922-48CADA0FFAAD",
  "Media": {
    "CreationTime": "2016-09-20T03:02:40Z",
    "CateId": 1,
    "Height": "1280",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "tag,tag2"
      ]
    },
    "Bitrate": "1148.77",
    "MediaId": "3e6149d5a8c944c09b1a8d2dc3e4****",
    "File": {
      "State": "Normal",
      "URL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4"
    },
    "PublishState": "Published",
    "Description": "A test video",
    "Width": "1280",
    "Size": "379860",
    "CoverURL": "http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png",
    "RunIdList": {
      "RunId": [
        "{\"RunId\":[\"cbad98d35629470fa05ff393d347****\"]}"
      ]
    },
    "Duration": "2.645333",
    "Fps": "25.0",
    "Title": "mytest.mp4",
    "Format": "mp4"
  }
}

錯誤碼

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

變更歷史

變更時間變更內容概要操作
暫無變更歷史