# 查询精调效果指标

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetModelCustomizationJobMetrics&Version=2024-01-01`

查询精调任务的效果指标名称列表，返回的指标名称可用于 GetModelCustomizationJobMetricData 接口获取详细指标数据。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**ModelCustomizationJobId** `string` `必选` | 模型精调任务 ID

模型精调任务 ID，格式如 `mcj-20241128104838-g9vqg`。可通过 ListModelCustomizationJobs 接口获取

## 响应参数

**Metrics** `string[]` | 指标名称列表

指标名称列表。返回的指标名称可作为 *GetModelCustomizationJobMetricData* 接口的 *Metrics* 入参，用于查询指标的详细打点数据。常见取值包括 `train/loss`、`eval/loss`、`train/total_tokens`、`eval/total_tokens` 等。


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetModelCustomizationJobMetrics&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "ModelCustomizationJobId": "mcj-20241128104838-g9vqg"
}
'
```

#### Response

```
{
    "ResponseMetadata": {
        "RequestId": "20241212162159B48FBC86E8E61A44B1",
        "Action": "GetModelCustomizationJobMetrics",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Metrics": [
            "eval/loss",
            "eval/total_tokens",
            "train/loss",
            "train/total_tokens"
        ]
    }
}
```