全部產品
Search

搜尋本產品

    Intelligent Media Services：QueryIProductionJob - 查詢智能生產任務

    文件中心

    Intelligent Media Services：QueryIProductionJob - 查詢智能生產任務

    更新時間：Mar 21, 2026

    調用QueryIProductionJob查詢智能生產任務狀態與結果。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:QueryIProductionJob

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ClientToken

    string

    否

    等冪參數

    JobId

    string

    是

    智慧工作提示 ID

    ****20b48fb04483915d4f2cd8ac****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID

    JobId

    string

    任務 ID

    ****20b48fb04483915d4f2cd8ac****
    Name

    string

    任務名稱

    測試工作
    FunctionName

    string

    需要使用的演算法功能名稱。取值：

    • Cover：智能封面

    • VideoClip：視頻摘要

    • VideoDelogo：視頻去表徵圖

    • VideoDetext：視頻去字幕

    • CaptionExtraction：字幕提取

    • VideoGreenScreenMatting：綠幕摳圖

    • FaceBeauty：視頻美顏

    • VideoH2V：視頻橫轉豎

    • MusicSegmentDetect：副歌檢測

    • AudioBeatDetection：節奏檢測

    • AudioQualityAssessment：音質檢測

    • SpeechDenoise：語音降噪

    • AudioMixing：音頻混音

    • MusicDemix：聲伴分離

    Cover
    Input

    object

    輸入媒體

    Type

    string

    輸入類型，取值：

    1. OSS：OSS 檔案地址

    2. Media：媒資 ID

    OSS
    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 為檔案路徑。

    oss://bucket/object
    Output

    object

    輸出媒體

    Type

    string

    媒體類型：

    • OSS：OSS 路徑

    • Media：媒資 ID

    OSS
    Biz

    string

    媒資所屬業務

    枚舉值：

    • VOD :

      VOD

    • IMS :

      IMS

    IMS
    Media

    string

    輸出媒體。當 Type 為 OSS 時返回 OSS 地址，Type 為 Media 時返回指定的媒資 ID 或新產生媒資 ID。

    OSS 地址規則為：

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object 其中 bucket 為和當前專案處於同一地區的 oss bucket 名稱，object 為檔案路徑。

    oss://bucket/object
    OutputUrl

    string

    當 Type=Media 時，為指定輸出檔案 OSS 地址

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

    TemplateId

    string

    模板 ID

    ****96e8864746a0b6f3****
    JobParams

    string

    演算法作業參數，JSON 對象，不同演算法對應參數內容不同。

    {"Model":"gif"}
    ScheduleConfig

    object

    任務配置資訊

    PipelineId

    string

    管道 ID

    a54fdc9c9aab413caef0d1150f565e86
    Priority

    integer

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

    • 最高優先順序：10。

    • 預設值：6。

    6
    UserData

    string

    使用者自訂資料，擷取結果時原樣返回

    {"test":1}
    Result

    string

    演算法輸出的結果資訊，不同 FunctionName 的輸出不同，以 JSON 格式輸出，詳見下面的補充說明

    {}
    CreateTime

    string

    建立時間，GMT 時間

    2022-07-07T07:16:11Z
    FinishTime

    string

    完成時間，GMT 時間

    2021-11-26T14:50:25Z
    Status

    string

    作業狀態。取值：

    • Queuing：排隊中。

    • Analysing：分析中。

    • Fail：失敗。

    • Success：成功。

    Success
    OutputFiles

    array

    輸出檔案數組

    string

    產生的檔案路徑與名稱

    output/xxx.mp4
    OutputMediaIds

    array

    string

    OutputUrls

    array

    輸出檔案 URL 數組

    string

    產生的檔案可存取 URL 路徑

    http://xxx

    Result 樣本說明

    Cover

    樣本：[{"Score":8.270855992569906,"Time":"28278.25","Url":"cover/test-00001.jpg"},{"Score":7.474117489692728,"Time":"25942.583333333332","Url":"cover/test-00002.jpg"}]

    其中 Score 為封面結果信賴度，Time 為封面幀時間戳記，Url 為封面檔案路徑。

    VideoClip

    樣本：{"VideoSummaryList":[{"EndTime":"5.28","StartTime":"0.28"}]}

    其中 VideoSummaryList 是個列表，表示從原視頻中截取的時間段，單位為秒

    VideoDelogo

    樣本：{}

    演算法無額外資訊輸出

    VideoDetext

    樣本：{}

    演算法無額外資訊輸出

    CaptionExtraction

    樣本：{}

    演算法無額外資訊輸出

    VideoGreenScreenMatting

    樣本：{}

    演算法無額外資訊輸出

    FaceBeauty

    樣本：{}

    演算法無額外資訊輸出

    VideoH2V

    樣本：{}

    演算法無額外資訊輸出

    MusicSegmentDetect

    樣本：[{"start":39.32,"end":63.85,"title":"副歌"},{"start":86.69,"end":114.45,"title":"副歌"},{"start":135.75,"end":160.27,"title":"副歌"}]

    AudioBeatDetection

    樣本：{}

    演算法無額外資訊輸出

    AudioQualityAssessment

    樣本： [{ "Discontinuity":"Good", "Loudness":"Excellent", "Worst MOS(0-5)":"0.38", "Discontinuity(0-5)":"3.52", "Speech Ratio":"48.55", "Loudness(0-5)":"4.91", "Worst Discontinuity(0-5)":"0.88", "Worst Coloration(0-5)":"0.42", "Channel":"1", "Coloration(0-5)":"0.99", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"3.28", "MOS":"Poor", "Worst Noisiness(0-5)":"0.91", "Double Talk Ratio(%)":"19.23", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Good", "Tag":"Valid", "MOS(0-5)":"1.01", "Loudness(-90dB-0dB)":"-0.59", "Coloration":"Bad", "Saturated Ratio(%)":"37.55" }, { "Discontinuity":"Fair", "Loudness":"Excellent", "Worst MOS(0-5)":"0.65", "Discontinuity(0-5)":"2.45", "Speech Ratio":"41.68", "Loudness(0-5)":"4.52", "Worst Discontinuity(0-5)":"0.66", "Worst Coloration(0-5)":"0.72", "Channel":"2", "Coloration(0-5)":"2.34", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"2.53", "MOS":"Poor", "Worst Noisiness(0-5)":"0.67", "Double Talk Ratio(%)":"25.93", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Fair", "Tag":"Valid", "MOS(0-5)":"1.69", "Loudness(-90dB-0dB)":"-4.82", "Coloration":"Fair", "Saturated Ratio(%)":"0.0" }]

    參數欄位解釋

    SpeechDenoise

    樣本：{}

    演算法無額外資訊輸出

    AudioMixing

    樣本：{}

    演算法無額外資訊輸出

    MusicDemix

    樣本：{}

    演算法無額外資訊輸出

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "Name": "測試工作",
  "FunctionName": "Cover",
  "Input": {
    "Type": "OSS",
    "Media": "oss://bucket/object"
  },
  "Output": {
    "Type": "OSS",
    "Biz": "IMS",
    "Media": "oss://bucket/object",
    "OutputUrl": "http(s)://bucket.oss-[RegionId].aliyuncs.com/object "
  },
  "TemplateId": "****96e8864746a0b6f3****",
  "JobParams": "{\"Model\":\"gif\"}",
  "ScheduleConfig": {
    "PipelineId": "a54fdc9c9aab413caef0d1150f565e86",
    "Priority": 6
  },
  "UserData": "{\"test\":1}",
  "Result": "{}",
  "CreateTime": "2022-07-07T07:16:11Z",
  "FinishTime": "2021-11-26T14:50:25Z",
  "Status": "Success",
  "OutputFiles": [
    "output/xxx.mp4"
  ],
  "OutputMediaIds": [
    ""
  ],
  "OutputUrls": [
    "http://xxx"
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

    變更歷史

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