全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：SubmitAnalysisJob - 提交預置模板分析作業

    文件中心

    ApsaraVideo Media Processing：SubmitAnalysisJob - 提交預置模板分析作業

    更新時間：Feb 25, 2026

    提交預置模板分析作業。

    介面說明

    • 通過本介面提交作業以後，ApsaraVideo for Media Processing服務會對輸入檔案進行智能分析，推薦出適合輸入檔案的預置模板，可通過查詢範本分析作業介面得到模板分析作業結果，也可使用非同步通知機制。

    • 預置模板分析的結果只保留半個月（從得到結果時算起），半個月後將被刪除。如果半個月後再使用推薦的預置模板提交作業將返迴轉碼作業失敗，失敗的錯誤碼為：AnalysisResultNotFound。

    QPS 限制

    本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:SubmitAnalysisJob

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Input

    string

    是

    作業輸入，JSON 對象。需在 OSS 控制台 Bucket 授權頁面將 Bucket 讀許可權授權給媒體轉碼服務。更多資訊請參見參數詳情。

    說明

    OSS 的地區需要與當前 MPS 所在地區保持一致。

    {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
    AnalysisConfig

    string

    否

    模板分析作業配置，根據您的實際需要按需設定。更多參數資訊請參見參數詳情。

    {"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
    UserData

    string

    否

    使用者自訂資料，可以使用中英文、數字、中劃線（-）等，不能以特殊字元開頭，最大長度 1024 個位元組。

    testid-001
    PipelineId

    string

    是

    管道 ID，可以通過 MPS 控制台>全域設定>管道查看。如果需要非同步通知，須保證此管道綁定了可用的訊息主題。

    bb558c1cc25b45309aab5be44d19****
    Priority

    string

    否

    任務在其對應管道內的轉碼優先順序。

    • 取值範圍：[1,10]，10 為最高優先順序。

    • 預設值：6。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    B52658D4-07AB-43CD-82B0-210958A65E23
    AnalysisJob

    object

    系統預置模板分析作業。

    CreationTime

    string

    作業添加時間。

    2014-01-10T12:00:00Z
    Percent

    integer

    轉碼進度。

    100
    State

    string

    作業狀態。

    • Submitted：已提交。

    • Analyzing：分析中。

    • Success：分析成功。

    • Fail：分析失敗。

    Success
    AnalysisConfig

    object

    作業配置。

    QualityControl

    object

    輸出品質控制。

    MethodStreaming

    string

    播放方式。

    • network：線上。

    • local：本地。

    • 預設值：network。

    network
    RateQuality

    string

    輸出品質等級。

    50
    PropertiesControl

    object

    屬性控制。

    Deinterlace

    string

    強制掃描模式判定。

    • Auto：自動。

    • Force：強製做 deinterlace。

    • None：強制不做 deinterlace。

    Force
    Crop

    object

    視頻裁切配置。

    Top

    string

    裁切上邊距。

    說明

    若 Mode 為 Auto 或 None，則此值失效。

    8
    Width

    string

    裁切後寬。

    說明

    若 Mode 為 Auto 或 None，則此值失效。

    8
    Height

    string

    裁切後高。

    說明

    若 Mode 為 Auto 或 None，則此值失效。

    8
    Left

    string

    裁切左邊距。

    說明

    若 Mode 為 Auto 或 None，則此值失效。

    8
    Mode

    string

    裁切方式。取值：

    • Auto：自動（預設）。

    • Force：強制。

    • None：強制不做。

    Auto
    Message

    string

    分析失敗時錯誤資訊。

    The resource operated \"PipelineId\" cannot be found
    Priority

    string

    任務在其對應管道內的優先順序。

    • 取值範圍：[1,10]。10 為最高優先順序。

    • 預設值：10。

    10
    MNSMessageResult

    object

    MNS 通知使用者作業完成的結果。

    MessageId

    string

    成功時訊息 ID。分析失敗時不返回此參數。

    3ca84a39a9024f19853b21be9cf9****
    ErrorMessage

    string

    失敗時錯誤資訊。分析成功時不返回此參數。

    The resource operated \"PipelineId\" cannot be found
    ErrorCode

    string

    失敗時錯誤碼。分析成功時不返回此參數。

    InvalidParameter.ResourceNotFound
    TemplateList

    object

    Template

    array<object>

    作業輸出的預置模板列表。

    array<object>

    作業輸出的預置模板詳細資料。

    Video

    object

    視頻編解碼配置。

    Bufsize

    string

    緩衝區大小。

    • 單位：Kb。

    • 預設值：6000。

    5000
    Degrain

    string

    獨立去噪演算法強度。

    5
    BitrateBnd

    object

    視頻平均碼率範圍。

    Max

    string

    總碼率上限。單位：Kbps。

    20
    Min

    string

    總碼率下限。單位：Kbps。

    10
    PixFmt

    string

    視頻顏色格式。包含 yuv420p，yuvj420p 等標準顏色格式。

    yuvj420p
    Codec

    string

    編解碼格式。預設值：H.264。

    H.264
    Height

    string

    視頻高。

    • 單位：px。

    • 預設值：視頻原始高度。

    1880
    Qscale

    string

    視頻品質控制度。

    15
    Bitrate

    string

    視頻平均碼率。單位：Kbps。

    10
    Maxrate

    string

    視頻碼率峰值。單位：Kbps。

    10
    Profile

    string

    編碼層級。

    • baseline：針對行動裝置。

    • main：針對標準解析度裝置。

    • high：針對高解析度裝置。

    • 預設值：high。

    baseline
    Crf

    string

    碼率-品質控制因子。

    • 預設值：編碼格式為 H264，預設值為 23。編碼格式為 H265，預設值為 26。

    • 如果設定了 Crf，則 Bitrate 的設定失效。

    27
    Gop

    string

    主要畫面格間最大幀數。預設值：250。

    1
    Width

    string

    視頻寬。

    • 單位：px。

    • 預設值：視頻原始寬度。

    1990
    Fps

    string

    幀率。

    • 當輸入檔案幀率超過 60 時取 60。

    • 預設值：取輸入檔案幀率。

    60
    Preset

    string

    視頻演算法器預置。支援 veryfast（超快）、fast（快）、medium（中等）、slow（慢）、slower（超慢）。預設值：medium。

    medium
    ScanMode

    string

    掃描模式。取值：

    • interlaced：交叉掃描。

    • progressive：順序掃描。

    progressive
    TransConfig

    object

    轉碼通用配置。

    TransMode

    string

    轉碼模式。取值：onepass、twopass、CBR。預設值：onepass。

    onepass
    State

    string

    模板的狀態。

    • Normal：正常。

    • Deleted：已刪除。

    Normal
    MuxConfig

    object

    轉碼封包配置。

    Gif

    object

    gif 格式。

    FinalDelay

    string

    gif 的 loop 間隔，單位為百分之一秒，比如 500 代表間隔為 5 秒。

    0
    Loop

    string

    gif 與 webp 迴圈次數，預設不迴圈。

    0
    Segment

    object

    切片配置。

    Duration

    string

    分區時間長度。單位：秒。

    60
    Name

    string

    模板名稱。

    FLV-UD
    Audio

    object

    音頻編解碼配置。

    Profile

    string

    音頻編碼預置。當 Codec 為 aac 時可取值：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

    aac_low
    Codec

    string

    音頻編解碼格式。預設值：aac。

    mp3
    Samplerate

    string

    採樣率。

    • 單位：Hz。

    • 預設值：44100。

    32000
    Qscale

    string

    音頻品質控制度。

    10
    Channels

    string

    聲道數。預設值：2。

    1
    Bitrate

    string

    輸出檔案的音頻碼率。

    • 單位：Kbps。

    • 預設值：128。

    8
    Id

    string

    轉碼模板 ID。

    S00000000-00****
    Container

    object

    容器。

    Format

    string

    容器格式。

    flv
    UserData

    string

    使用者自訂資料。

    testid-001
    Code

    string

    分析失敗時錯誤碼。分析成功時不返回此參數。

    InvalidParameter.ResourceNotFound
    InputFile

    object

    作業輸入。

    Object

    string

    OSS 的 Object。

    example.flv
    Location

    string

    OSS 的服務地區。

    oss-cn-hangzhou
    Bucket

    string

    OSS 的 Bucket。

    example-bucket
    PipelineId

    string

    管道 ID。

    bb558c1cc25b45309aab5be44d19****
    Id

    string

    模板分析作業 ID。

    57f6aa3f84824309bcba67231b40****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
  "AnalysisJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "Percent": 100,
    "State": "Success",
    "AnalysisConfig": {
      "QualityControl": {
        "MethodStreaming": "network",
        "RateQuality": "50"
      },
      "PropertiesControl": {
        "Deinterlace": "Force",
        "Crop": {
          "Top": "8",
          "Width": "8",
          "Height": "8",
          "Left": "8",
          "Mode": "Auto"
        }
      }
    },
    "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
    "Priority": "10",
    "MNSMessageResult": {
      "MessageId": "3ca84a39a9024f19853b21be9cf9****",
      "ErrorMessage": "The resource operated \\\"PipelineId\\\" cannot be found",
      "ErrorCode": "InvalidParameter.ResourceNotFound"
    },
    "TemplateList": {
      "Template": [
        {
          "Video": {
            "Bufsize": "5000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "20",
              "Min": "10"
            },
            "PixFmt": "yuvj420p",
            "Codec": "H.264",
            "Height": "1880",
            "Qscale": "15",
            "Bitrate": "10",
            "Maxrate": "10",
            "Profile": "baseline",
            "Crf": "27",
            "Gop": "1",
            "Width": "1990",
            "Fps": "60",
            "Preset": "medium",
            "ScanMode": "progressive"
          },
          "TransConfig": {
            "TransMode": "onepass"
          },
          "State": "Normal",
          "MuxConfig": {
            "Gif": {
              "FinalDelay": "0",
              "Loop": "0"
            },
            "Segment": {
              "Duration": "60"
            }
          },
          "Name": "FLV-UD",
          "Audio": {
            "Profile": "aac_low",
            "Codec": "mp3",
            "Samplerate": "32000",
            "Qscale": "10",
            "Channels": "1",
            "Bitrate": "8"
          },
          "Id": "S00000000-00****",
          "Container": {
            "Format": "flv"
          }
        }
      ]
    },
    "UserData": "testid-001",
    "Code": "InvalidParameter.ResourceNotFound",
    "InputFile": {
      "Object": "example.flv",
      "Location": "oss-cn-hangzhou",
      "Bucket": "example-bucket"
    },
    "PipelineId": "bb558c1cc25b45309aab5be44d19****",
    "Id": "57f6aa3f84824309bcba67231b40****"
  }
}

    錯誤碼

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

    變更歷史

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