全部產品
Search

搜尋本產品

    Intelligent Media Services：SubmitDynamicImageJob

    文件中心

    Intelligent Media Services：SubmitDynamicImageJob

    更新時間：Sep 11, 2026

    本介面用於提交產生動態圖像的任務。

    介面說明

    該介面為非同步介面，提交任務後回傳任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過查詢動態圖像任務詳細資訊主動查詢任務狀態。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:SubmitDynamicImageJob

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    否

    任務名稱。

    SampleJob
    Input

    object

    是

    任務輸入。

    Media

    string

    是

    輸入媒體。

    • 當 Type 為 OSS 時填入 OSS 位址。

    • Type 為 Media 時填入媒資 ID。

    OSS 位址規則為：

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object

    其中 bucket 為和目前專案處於同一區域的 OSS bucket 名稱，object 為檔案路徑。

    說明

    URL 中的 OSS bucket 需要先新增到 IMS儲存管理後再使用。

    oss://bucket/object.mp4
    Type

    string

    是

    輸入類型，取值：

    • OSS：OSS 檔案位址。

    • Media：媒資 ID。

    枚舉值：

    • Media :

      媒資 ID。

    • OSS :

      OSS 位址。

    OSS
    Output

    object

    是

    任務輸出。

    Media

    string

    是

    輸出媒體，支援 OSS 位址和媒資 ID 兩種。 OSS 位址規則為

    • oss://bucket/object

    • http(s)://bucket.oss-[regionId].aliyuncs.com/object

    其中 bucket 為和目前專案處於同一區域的 OSS bucket 名稱，object 為檔案路徑。

    說明

    URL 中的 OSS bucket 需要先新增到 IMS儲存管理後再使用。

    ****96e8864746a0b6f3****
    Type

    string

    是

    輸出類型，取值：

    • OSS：OSS 檔案位址。

    • Media：媒資 ID。

    枚舉值：

    • Media :

      媒資 ID。

    • OSS :

      OSS 位址。

    Media
    TemplateConfig

    object

    是

    截圖範本設定。

    OverwriteParams

    object

    否

    覆蓋參數。

    Format

    string

    否

    動態圖像格式，取值：

    • gif。

    • webp。

    枚舉值：

    • gif :

      gif

    • webp :

      webp

    gif
    Fps

    integer

    否

    影格率。取值範圍：[1, 60]。

    15
    Height

    integer

    否

    輸出動態圖像高度。取值範圍：[128, 4096]。

    720
    LongShortMode

    boolean

    否

    是否開啟橫直式自適應（長短邊模式）。取值：

    • true：開啟橫直式自適應。

    • false：關閉橫直式自適應。

    預設值：true。

    說明

    轉碼輸出的寬對應輸入片源的長邊（直式為片源的高），高對應輸入影片的短邊（直式為片源的寬）。

    枚舉值：

    • true :

      true

    • false :

      false

    false
    ScanMode

    string

    否

    掃描模式。可取值：

    • interlaced：交叉掃描。

    • progressive：順序掃描。預設值。

    枚舉值：

    • progressive :

      順序掃描。

    • interlaced :

      交叉掃描。

    progressive
    TimeSpan

    object

    否

    時間軸參數。

    Duration

    string

    否

    持續時長。

    • 格式：hh:mm:ss[.SSS]或sssss[.SSS]。

    • 取值範圍 ：[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

    01:59:59.999 or 32000.23
    End

    string

    否

    截尾時長，表示切掉尾部的若干時長。設定此值時，參數 Duration 失效。

    • 格式：hh:mm:ss[.SSS]或sssss[.SSS]。

    • 取值範圍 ：[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

    01:59:59.999 or 32000.23
    Seek

    string

    否

    開始時間點。

    • 格式：hh:mm:ss[.SSS]或sssss[.SSS]。

    • 取值範圍 ：[00:00:00.000,23:59:59.999]或[0.000,86399.999]。

    01:59:59.999 or 32000.23
    Width

    integer

    否

    輸出動態圖像寬度。取值範圍：[128, 4096]。

    1024
    TemplateId

    string

    是

    範本 ID。

    ****96e8864746a0b6f3****

    ScheduleConfig

    object

    否

    排程設定。

    PipelineId

    string

    否

    管線 ID。

    ****96e8864746a0b6f3****

    Priority

    integer

    否

    優先順序，1-10，預設 6。數值越大，優先順序越高。

    6
    UserData

    string

    否

    使用者自訂資訊。

    {"SampleKey": "SampleValue"}

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    PlainResponse

    JobId

    string

    任務 ID。

    ****20b48fb04483915d4f2cd8ac****
    RequestId

    string

    請求 ID。

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

    樣本

    正常返回樣本

    JSON格式

    {
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "RequestId": "******11-DB8D-4A9A-875B-275798******"
}

    錯誤碼

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

    變更歷史

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