全部產品
Search

搜尋本產品

    ：GetAIImageJobs - 查詢AI圖片工作清單

    文件中心

    ：GetAIImageJobs - 查詢AI圖片工作清單

    更新時間：Dec 15, 2025

    調用本介面查詢AI圖片工作清單。

    介面說明

    • 目前本介面支援的服務地區：華北 2（北京）、華東 2（上海）。

    • 先通過 SubmitAIImageJob 介面提交 AI 圖片處理任務，再調用本介面查詢 AI 圖片工作清單資訊。

    • 本介面一次最多可查詢 10 個 AI 圖片處理任務。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetAIImageJobs

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    JobIds

    string

    是

    AI 圖片處理任務 ID。由一個或多個 JobId 組成，JobId 為調用 SubmitAIImageJob 介面返回參數 JobId 的值。

    • 最多支援 10 個 ID。

    • 多個 ID 之間使用半形逗號（,）分隔。

    cf08a2c6e11e*****de1711b738b9067

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    7721B494-1F78-4E*****E8-A7CEE7315BFA
    AIImageJobList

    array<object>

    AI 圖片處理工作清單。

    object

    AI 圖片處理任務詳情。

    Status

    string

    任務狀態：

    • success：成功。

    • fail：失敗。

    success
    CreationTime

    string

    AI 圖片處理任務的建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2020-10-15T03:30:03Z
    AIImageResult

    string

    AI 圖片的 OSS 地址。

    說明

    為任務結果，因此該地址不提供完整的鑒權資訊，需要鑒權資訊需使用者產生或者調用 ListAIImage 介面擷取媒資結果。

    [{"Score":5.035636554444242,"Url":"http://outin-*****.oss-cn-shanghai.aliyuncs.com/357a8748c577*****789d2726e6436aa/image/ai/b0a7612554d*****5cbe3-00001.gif"}]
    VideoId

    string

    視頻 ID。

    357a8748c577*****789d2726e6436aa
    JobId

    string

    AI 圖片處理任務 ID。

    cf08a2c6e11e*****de1711b738b9067
    UserData

    string

    自訂設定。

    • 必須是 JSON 字串。

    • 需要包含 MessageCallback 或者 Extend 參數。

    • 最大長度為 512 個位元組。

    參數構造詳情，請參見 UserData 。

    {"Extend":{"localId":"****","test":"www"}}
    Code

    string

    錯誤碼。

    Success
    Message

    string

    錯誤資訊。

    success
    TemplateConfig

    string

    提交任務時，對指定模板的配置資訊的快照。

    {"Format":"gif","SetDefaultCover":"true"}
    TemplateId

    string

    AI 模板 ID。

    5a86a00f15194*****d7fe7de1b4a173

    錯誤碼

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

    變更歷史

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