Alibaba Cloud Model Studio：非同步任務管理 API

傳參方式

欄位

類型

必選

描述

樣本值

Header

Authorization

String

是

API-Key，例如：Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

是

需查詢的任務ID

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

欄位

類型

描述

樣本值

request_id

String

本次請求的系統唯一碼

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

output

Object

• 任務成功時，output 包含模型產生的結果對象，具體內容因任務類型而異

• 任務失敗或部分失敗時，output 會返回對應的 code 和 message，說明失敗原因

• 對於包含多個子任務的任務，output 可能同時包含成功的子任務結果和失敗的錯誤資訊

-

output.task_id

String

查詢任務的 task_id

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

output.task_status

String

任務狀態

• 對於包含多個子任務的任務，只要有一個子任務成功，整個任務會被標記為成功

• 對於失敗的子任務，會在 output 中展示具體報錯

任務狀態：

• PENDING：任務排隊中

• RUNNING：任務處理中

• SUCCEEDED：任務執行成功

• FAILED：任務執行失敗

• UNKNOWN：任務不存在或狀態未知

output.submit_time

String

任務提交時間

2023-12-20 21:36:31.896

output.scheduled_time

String

任務調度時間，即開始執行時間

2023-12-20 21:36:39.009

output.end_time

String

任務結束時間

2023-12-20 21:36:45.913

output.code

String

錯誤碼，僅在任務失敗時返回

-

output.message

String

錯誤資訊，僅任務失敗時返回

-

output.task_metrics

Object

任務指標，包含子任務狀態的統計資訊

{

"TOTAL": 4, //子任務總數

"SUCCEEDED": 3, //子任務成功數

"FAILED": 1 //子任務失敗數

}

usage

Object

本次請求產生的計量資訊，根據實際任務的不同，相關的計量資訊也有所不同

"usage": {"image_count": 1}

傳參方式

欄位

類型

必選

描述

樣本值

Header

Authorization

String

是

API-Key，例如：Bearer sk-xxx

Bearer sk-xxx

Params

task_id

String

否

需要查詢任務的 task_id

若指定task_id，介面僅返回該任務的狀態資訊；若需批量查詢多個任務狀態，請勿傳入此參數

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

start_time

String

否

任務開始時間，格式為：YYYYMMDDhhmmss

• 若未指定開始時間（start_time為空白），系統將查詢指定結束時間（end_time）前24小時的資料

• 若開始和結束時間均未指定（均為空白），系統預設查詢最近24小時的資料。

• 請確保您設定的開始和結束時間的差距不超過24小時

20230420193058 代表 2023 年 4 月 20 日 19 點 30 分 58 秒

end_time

String

否

任務結束時間，格式為：YYYYMMDDhhmmss

• 若未指定結束時間（end_time為空白），系統將查詢指定開始時間（start_time）後24小時的資料。

• 請確保您設定的開始和結束時間的差距不超過24小時

model_name

String

否

模型名稱

wanx-v1

status

String

否

任務狀態：

• PENDING：任務排隊中

• RUNNING：任務處理中

• SUCCEEDED：任務執行成功

• FAILED：任務執行失敗

• CANCELED：任務取消成功

• UNKNOWN：任務不存在或狀態未知

page_no

Integer

否

當前頁，預設查詢第1頁

-

page_size

Integer

否

每頁查詢條數，預設查詢10條

-

欄位

類型

描述

樣本值

request_id

String

本次請求的系統唯一碼

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

data

Array

查詢結果清單

"data": [
    {
        "api_key_id": "235",
        "caller_uid": "1808342417264262",
        "end_time": 1682527200093,
        "gmt_create": 1682514589152,
        "model_name": "paraformer-16k-1",
        "region": "cn-hangzhou",
        "request_id": "32b67b58-xxxx-xxxx-xxxx-230f0aee64d9",
        "start_time": 1682515862179,
        "status": "FAILED",
        "task_id": "cf52b16b-xxxx-xxxx-xxxx-17f9c211440c",
        "user_api_unique_key": "apikey:v1:audio:asr:transcription:paraformer-16k-1"
    }
]

data[].api_key_id

String

API Key的id

data[].caller_parent_id

String

阿里雲主帳號ID

data[].caller_uid

String

阿里雲帳號ID

data[].gmt_create

Long

任務建立時間，Date時間毫秒數

data[].start_time

Long

任務開始時間，Date時間毫秒數

data[].end_time

Long

任務結束時間，Date時間毫秒數

data[].region

String

地區，例如：cn-hangzhou

data[].request_id

String

提交任務的請求id

data[].status

String

任務狀態：

• PENDING：任務排隊中

• RUNNING：任務處理中

• SUCCEEDED：任務執行成功

• FAILED：任務執行失敗

• CANCELED：任務取消成功

• UNKNOWN：任務不存在或狀態未知

data[].task_id

String

任務id

data[].user_api_unique_key

String

API 的唯一key（提交任務時，模型API的各要素唯一索引）

data[].model_name

String

模型名稱

page_no

Integer

當前頁

"page_no": 1

page_size

Integer

每頁查詢條數

"page_size": 10

total_page

Integer

總頁數

"total_page": 4

total

Integer

總條數

"total": 39

code

String

調用失敗的時候返回的錯誤碼

"code": "Throttling.RateQuota"

message

String

調用失敗的時候返回的錯誤資訊

"message": "Requests rate limit exceeded, please try again later."

傳參方式

欄位

類型

必選

描述

樣本值

Header

Authorization

String

是

API-Key，例如：Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

是

待取消的任務 task_id

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

欄位

類型

描述

樣本值

request_id

String

本次請求的系統唯一碼

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

code

String

調用失敗的時候返回的錯誤碼

"code": "Throttling.RateQuota"

message

String

調用失敗的時候返回的錯誤資訊

"message": "Requests rate limit exceeded, please try again later."