查询和管理调优任务-大模型服务平台百炼(Model Studio)-阿里云帮助中心

列举调优任务

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request GET "https://dashscope.aliyuncs.com/api/v1/fine-tunes?model=qwen3-14b&page_no=2" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

输入参数

参数名称	类型	传参方式	是否必填	参数说明
page_no	Integer	Query	否	默认1
page_size	Integer	Query	否	默认10，最大值1000，最小值1
model	String	Query	否	模型ID，指定该参数表示只列举基于该模型的调优任务

返回样例

{
          "request_id": "2182ef64-6398-457b-b3f6-5fde5fd6b388",
          "output": {
              "page_no": 2,
              "page_size": 10,
              "total": 12,
              "jobs": [
                  {
                      "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": [],
                      "validation_file_ids": [],
                      "training_datasets": [
                          {"data_source_type": "file_id", "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"}
                      ],
                      "validation_datasets": [],
                      "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
                  },
                  {
                      "job_id": "ft-202410291512-1851",
                      "job_name": "ft-202410291512-1851",
                      "status": "CANCELED",
                      "model": "qwen3-14b",
                      "base_model": "qwen3-14b",
                      "training_file_ids": [],
                      "validation_file_ids": [],
                      "training_datasets": [
                          {"data_source_type": "file_id", "file_id": "86a9fe7f-dd77-43b0-9834-2170e12339ec"},
                          {"data_source_type": "file_id", "file_id": "03ead352-6190-4328-8016-61821c23d4fc"}
                      ],
                      "validation_datasets": [],
                      "hyper_parameters": {
                          "n_epochs": 3,
                          "batch_size": 32,
                          "max_length": 8192,
                          "learning_rate": "1.6e-5",
                          "lr_scheduler_type": "linear",
                          "split": 0.9
                      },
                      "code": "1",
                      "training_type": "sft",
                      "create_time": "2024-10-29 15:12:00",
                      "workspace_id":"llm-v71tlv***",
                      "user_identity": "1396993924585947",
                      "modifier": "1396993924585947",
                      "creator": "1396993924585947",
                      "end_time": "2024-10-29 15:16:00",
                      "group": "llm",
                      "usage": 0
                  }
              ]
          }
      }

返回参数

参数名称

类型

参数说明

request_id

String

本次请求的ID。

output

Object

查询返回的详细信息。

output.page_no

Integer

页码。

output.page_size

Integer

每页显示的数据量。

output.total

Integer

调优任务总计数量。

output.jobs

Array

多个调优任务详情。

点击此处查看调优任务详情对象

参数名称	类型	参数说明
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	兼容字段，新任务始终返回空数组，请使用 training_datasets。
output.validation_file_ids	Array	兼容字段，新任务始终返回空数组，请使用 validation_datasets。
output.training_datasets	Array of Dataset	训练数据集列表。
output.validation_datasets	Array of Dataset	测试数据集列表。
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 输出的模型返回

查询调优任务详情

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request GET "https://dashscope.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": [],
              "validation_file_ids": [],
              "training_datasets": [
                  {"data_source_type": "file_id", "file_id": "976bd01a-f30b-4414-86fd-50c54486e3ef"}
              ],
              "validation_datasets": [],
              "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
          }
      }

视频生成模型

关注 output.status（SUCCEEDED 表示训练完成）和 output.usage（训练消耗的总 Token 数量）。

{
    "request_id": "9bbb953c-bef2-4b59-9fc5-xxxxxxxxx",
    "output": {
        "job_id": "ft-202511111122-xxxx",
        "status": "SUCCEEDED",
        "finetuned_output": "wan2.5-i2v-preview-ft-202511111122-xxxx",
        "model": "wan2.5-i2v-preview",
        "base_model": "wan2.5-i2v-preview",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {"data_source_type": "file_id", "file_id": "xxxxxxxxxxxx"}
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "n_epochs": 400,
            "learning_rate": 2.0E-5,
            "split": 0.9,
            "eval_epochs": 50
        },
        "training_type": "efficient_sft",
        "create_time": "2025-11-11 11:22:22",
        "end_time": "2025-11-11 16:49:01",
        "usage": 432000,
        "output_cnt": 8
    }
}

图像生成模型

{
    "request_id": "03d738f5-3720-90b0-9c7b-xxxxxxxxx",
    "output": {
        "job_id": "ft-202606030110-xxxx",
        "status": "SUCCEEDED",
        "finetuned_output": "wan2.7-image-pro-ft-202606030110-xxxx",
        "model": "wan2.7-image-pro",
        "base_model": "wan2.7-image-pro",
        "training_file_ids": [],
        "validation_file_ids": [],
        "training_datasets": [
            {"data_source_type": "file_id", "file_id": "xxxxxxxxxxxx"}
        ],
        "validation_datasets": [],
        "hyper_parameters": {
            "max_steps": 800,
            "learning_rate": 3.0E-5,
            "eval_steps": 200,
            "max_token_length": "2k",
            "max_pixels": "2k",
            "val_img_size": "2k",
            "generation_type": "t2i",
            "lora_rank": 32
        },
        "training_type": "efficient_sft",
        "create_time": "2026-06-03 01:10:47",
        "end_time": "2026-06-03 01:38:53",
        "usage": 10273216,
        "output_cnt": 1
    }
}

返回参数

参数名称	类型	参数说明
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	兼容字段，新任务始终返回空数组，请使用 training_datasets。
output.validation_file_ids	Array	兼容字段，新任务始终返回空数组，请使用 validation_datasets。
output.training_datasets	Array of Dataset	训练数据集列表。
output.validation_datasets	Array of Dataset	测试数据集列表。
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 输出的模型返回。

获取调优任务日志

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request GET "https://dashscope.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/logs?offset=10&line=10" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

输入参数

字段	类型	传参方式	必选	描述
job_id	String	Url Path	是	要打印日志的调优任务ID，可通过创建训练任务或列举训练任务接口获取。
offset	Number	Query	否	忽略前`offset`行输出，从第`offset+1`行开始读取。不能超过当前已有输出的总行数，超过则不会有输出信息返回。默认值为0。
line	Number	Query	否	从`offset+1`行（包含）起，读取`line`行输出信息，如果本次请求的输出不足`line`行，则以实际输出为准。默认值为100，上限为1000。

返回样例

{
          "request_id": "ce49b45d-fe46-474e-9e1b-3e7427ffdf5a",
          "output": {
              "total": 20,
              "logs": [
                  "{'train_runtime': 216.3999, 'train_samples_per_second': 2.066, 'train_steps_per_second': 0.014, 'train_loss': 0.9122632344563802, 'epoch': 0.8571428571428571}",
                  " Actual number of consumed tokens is 279808!",
                  " Uploaded checkpoint!",
                  " Fine-tune succeeded!",
                  " use checkpoint-3 as final checkpoint",
                  "2024-10-29 17:03:47,719 - INFO - transfer for inference succeeded, start to deliver it for inference",
                  "2024-10-29 17:09:43,322 - INFO - start to save checkpoint",
                  "2024-10-29 17:11:24,689 - INFO - finetune-job succeeded",
                  "2024-10-29 17:11:25,130 - INFO - training usage 279808",
                  "2024-10-29 17:11:25,175 - INFO - ##FT_COMPLETE##"
              ]
          }
      }

返回参数

参数名称	类型	参数说明
request_id	String	本次请求的ID。
output	Object	查询返回的详细信息。
output.total	Integer	日志总计行数。
output.logs	Array	输出的日志。

取消调优任务

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request POST "https://dashscope.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>/cancel" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

输入参数

字段	类型	传参方式	必选	描述
job_id	String	Url Path	是	要取消的调优任务ID，可通过创建训练任务或列举训练任务接口获取。

返回样例

{
          "request_id": "670fca9d-48dd-4c5a-83e7-33bcc20420f8",
          "output": {
              "status": "success"
          }
      }

返回参数

参数名称	类型	参数说明
request_id	String	本次请求的ID。
output	Object	取消操作返回的详细信息。

删除调优任务

Windows CMD 请将${DASHSCOPE_API_KEY}替换为 %DASHSCOPE_API_KEY%，PowerShell 请替换为 $env:DASHSCOPE_API_KEY

curl --location --request DELETE "https://dashscope.aliyuncs.com/api/v1/fine-tunes/<替换为您的调优任务id>" \
      --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
      --header 'Content-Type: application/json'

输入参数

字段	类型	传参方式	必选	描述
job_id	String	Url Path	是	要删除的调优任务ID，可通过创建训练任务或列举训练任务接口获取。

返回样例

{
          "request_id": "7d7e1469-df77-4163-83ce-54425df744ed",
          "output": {
              "status": "success"
          }
      }

返回参数

参数名称	类型	参数说明
request_id	String	本次请求的ID。
output	Object	删除操作返回的详细信息。

请求错误码说明

请求异常时返回

字段	类型	描述	示例值
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，通过工单联系阿里云工程师进行排查。