更新时间：2026-08-26 GMT+08:00

查询精调训练任务指标信息 - ShowFtJobMetrics

功能介绍

查询精调训练任务指标信息，如：训练loss等。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v2/{project_id}/training-jobs/{training_job_id}/ft-metrics

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：用户项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及。取值范围：1 - 64字符，字母、数字和中划线。默认取值：不涉及。
training_job_id	是	String	参数解释：训练作业ID。获取方法请参见查询训练作业列表。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
loss	Object	训练loss信息
eval_loss	Object	评测loss信息
training_info	Object	训练预估时长信息
train_process	Double	训练进度信息
data	FtMetricData object	训练指标

表3 FtMetricData
参数	参数类型	描述
format_version	String	固定值 "1.0"，标识数据格式版本
timestamp	String	文件生成时间，ISO 8601 格式（如 2026-07-18T10:30:00Z）
metrics	Array of FtMetric objects	训练指标结构体

表4 FtMetric
参数	参数类型	描述
name_cn	String	指标中文名称，如训练指标、准确率，前端用作图例或列名
name_en	String	指标英文名称，如 train_loss、val_accuracy，前端用作图例或列名
des_en	String	指标中文解释，如训练指标，前端用作针对指标进行释义
des_cn	String	指标英文解释，如 train loss，前端用作针对指标进行释义
type	String	指标绘图类型，可选 line（折线图）或 pie（饼图）、tabel（表格）、scalar（单值），可扩展 image 等
group	String	逻辑分组，如 training、validation、test，可扩展，用于前端分栏或过滤
group_by	Array of strings	指定哪些数据点字段用于分组生成多个系列（如 ["layer","feature"]）
x_axis	String	明确指定用作 X 轴的数据点字段名（如 "step"、"epoch"、"timestamp"）
tags	Array of strings	逻辑分组，如表面loss，用于前端分组或过滤
unit	String	单位，如 %、samples/sec，仅用于展示
data	Object	数据点数组，严格按时间/步序升序排列

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_msg	String	错误信息。
error_code	String	错误码。
error_solution	String	错误解决建议。

请求示例

如下以查询uuid为3faf5c03-aaa1-4cbe-879d-24b05d997347的训练作业为例。

GET https://{endpoint}/v2/{project_id}/training-jobs/3faf5c03-aaa1-4cbe-879d-24b05d997347/ft-metrics

响应示例

状态码：200

指标详情信息

{
  "train_process" : 1.0
}

状态码：400

通用的错误应答消息体格式；如下为id是3f5d6706-7b67-408d-8ba0-ec08048c45ee的训练作业未找到时的返回信息。

{
  "error_msg" : "Job not found.",
  "error_code" : "ModelArts.2755",
  "error_solution" : "Check whether the training job in the request is valid."
}

状态码

状态码	描述
200	指标详情信息
400	通用的错误应答消息体格式；如下为id是3f5d6706-7b67-408d-8ba0-ec08048c45ee的训练作业未找到时的返回信息。

错误码

请参见错误码。

父主题： 训练管理