調優任務對象 - Alibaba Cloud Model Studio

描述模型微調訓練任務對象的屬性和結構。

當前模型調優 API 僅在新加坡 Region 開放。如您使用其他 Region，請通過該 Region 的百鍊控制台完成模型調優操作。

調優任務對象（Fine-tune Job）表示一次模型調優任務。通過建立調優任務、查詢調優任務詳情、列舉調優任務等介面返回。

欄位說明

參數名稱	類型	參數說明
request_id	String	本次請求的ID。
output	Object	調優任務的詳細資料。
output.job_id	String	本次調優的任務ID，用於後續查詢狀態。建置規則：`ft-{yyyyMMddHHmm}-{4位uuid}`。
output.jobs_name	String	同`output.job_id`。
output.status	String	本次調優任務的狀態。
output.finetuned_output	String	僅調優任務狀態為“SUCCEED”時出現，返回的是調優完成的模型ID。
output.model	String	調優任務使用的模型ID。
output.base_model	String	調優任務使用的模型對應的基本模型ID。比如：調優任務`ft-202410291653-1c7f`使用的基本模型是`qwen3-14b`。
output.training_file_ids	Array	調優檔案ID列表。
output.validation_file_ids	Array	驗證檔案ID列表。
output.hyper_parameters	Object	顯性聲明過的超參表。
output.training_type	String	調優方法。
output.create_time	String	調優任務建立時間。
output.workspace_id	String	調優任務所屬的業務空間ID。
output.user_identity	String	該調優任務隸屬的主帳號UID。
output.modifier	String	對該調優任務進行最後一次操作的帳號UID。（比如：某個子帳號取消了該任務，該子帳號UID會顯示在這裡）
output.creator	String	該調優任務建立人UID。
output.end_time	String	調優任務結束時間，當任務狀態為“SUCCEED”、“FAILED”、“CANCELED”時出現。
output.group	String	模型調優的任務類型。
output.usage	Integer	調優任務消耗的Token（count）數，計費計算公式請參考：計費項目。當任務狀態為“SUCCEED”、“CANCELED”時出現。
output.output_cnt	Integer	當前任務已產出的 Checkpoint 數量。僅對支援多 Checkpoint 輸出的模型（如 `cosyvoice-v3-flash`）返回。Checkpoint 詳細列表可通過列舉 Checkpoint 介面擷取。
output.max_output_cnt	Integer	單次任務可產出的 Checkpoint 數量上限。`output_cnt` 超出上限的部分會按調優充分度截斷。僅對支援多 Checkpoint 輸出的模型返回。

調優任務狀態

任務狀態	含義
PENDING	調優待開始。
QUEUING	調優正在排隊（同時只有一個調優任務可以進行）
RUNNING	調優進行中中。
CANCELING	調優正在取消中。
SUCCEEDED	調優成功。
FAILED	調優失敗。
CANCELED	調優已經取消。

請求錯誤碼說明

請求異常時返回

欄位	類型	描述	樣本值
code	String	錯誤碼。	NotFound
request_id	String	本次請求的系統唯一碼。	6332fb02-3111-43f0-bf79-f9e8c5ffa7f9
message	String	錯誤資訊。	Not Found!

請求異常樣本

{
  "code": "NotFound",
  "request_id": "BE213CDD-8A5C-59EE-9A67-055EAB0CB59B",
  "message": "Not Found!"
}

錯誤碼列表

HTTP狀態代碼	錯誤碼	錯誤資訊舉例	含義	處理方式
400	InvalidParameter	Missing training files	參數錯誤，缺少參數或者參數格式問題等。	根據錯誤資訊，修正您的參數。
400	UnsupportedOperation	The fine-tune job can not be deleted because it is succeeded,failed or canceled	當資源處於特定狀態時，無法對其進行操作。	待要操作的資源到達可操作狀態時再進行操作。
404	NotFound	Not found!	要查詢/操作的資源不存在。	檢查要查詢/操作的資源ID是否錯誤。
409	Conflict	Model instance xxxxx already exists, please specify a suffix	已存在deployed_model名為xxxxx的部署執行個體，需要指定尾碼進行區分。	為部署指定唯一的尾碼。
429	Throttling	Too many fine-tune job in running, please retry later. Only 20 fine-tune job in running or succeeded allowed per user.	資源的建立觸發平台限制。	刪除不再使用的模型。
500	InternalError	Internal server error!	內部錯誤。	記錄 request_id，通過工單聯絡阿里雲工程師進行排查。