查詢調優任務詳情

查詢指定模型微調訓練任務的詳細資料。

Windows CMD 請將${DASHSCOPE_API_KEY}替換為 %DASHSCOPE_API_KEY%，PowerShell 請替換為 $env:DASHSCOPE_API_KEY

curl --location --request GET "https://dashscope-intl.aliyuncs.com/api/v1/fine-tunes/<替換為您的調優任務id>" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

輸入參數

欄位	類型	傳參方式	必選	描述
job_id	String	Url Path	是	要查詢的調優任務的ID。即建立調優任務返回參數中的job_id。

返回範例

{
          "request_id": "c59b2145-a93c-4e00-b610-4d7cc5c521a2",
          "output": {
              "job_id": "ft-202410291653-1c7f",
              "job_name": "ft-202410291653-1c7f",
              "status": "SUCCEEDED",
              "finetuned_output": "qwen3-14b-suffix-ft-202410291653-1c7f",
              "model": "qwen3-14b",
              "base_model": "qwen3-14b",
              "training_file_ids": [
                  "976bd01a-f30b-4414-86fd-50c54486e3ef"
              ],
              "validation_file_ids": [
      
              ],
              "hyper_parameters": {
                  "n_epochs": 3,
                  "batch_size": 32,
                  "max_length": 8192,
                  "learning_rate": "1.6e-5",
                  "lr_scheduler_type": "linear",
                  "split": 0.9
              },
              "training_type": "sft",
              "create_time": "2024-10-29 16:53:53",
              "workspace_id":"llm-v71tlv***",
              "user_identity": "1396993924585947",
              "modifier": "1396993924585947",
              "creator": "1396993924585947",
              "end_time": "2024-10-29 17:11:26",
              "group": "llm",
              "usage": 279808
          }
      }

返回參數

參數名稱	類型	參數說明
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 輸出的模型返回。

請求錯誤碼說明

請求異常時返回

欄位	類型	描述	樣本值
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，通過工單聯絡阿里雲工程師進行排查。