调优任务对象-大模型服务平台百炼(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，通过工单联系阿里云工程师进行排查。