三单匹配-异步训练结果查询

一、接口描述

异步查询模型训练任务状态接口

输入参数

参数	参数类型	必填	描述
taskId	string	Y	训练任务唯一标识，由提交接口返回

输出参数

字段一律平铺在 data 下，随 status 不同：

输出参数	类型	参数说明
data.taskId	String	任务 ID
data.status	String	`PROCESSING` / `COMPLETED` / `FAILED`
data.taskTraceId	String	任务侧 trace，拿它可以在服务日志里查到本次训练的全过程
data.error	String	失败原因，`FAILED` 时返回

以下字段 COMPLETED 时返回：

输出参数	类型	参数说明
data.clientId	String	租户
data.modelVersion	String	产出的版本名，拿它去调部署接口的 `ACTIVATE`
data.threshold	Number	选出的判定阈值。打分接口会返回它，调用方据此裁剪候选
data.cvMetrics	Object	5 折交叉验证的 OOF 指标，见下表。判断这一版能不能上的主要依据
data.nPos	Integer	正样本数
data.nNeg	Integer	负样本数
data.nRows	Integer	训练总行数（去重后）
data.nTrees	Integer	最终模型的树数
data.elapsedSeconds	Number	训练耗时
data.datasetId	String	样本内容哈希。两次训练的值相同 = 训练数据逐字节相同，调参时靠它确认指标差异只来自超参。快照写失败时为 `null`
data.sampleReuse	String	本次样本怎么来的：`full`（全量采样）/ `incremental`（部分复用）/ `exact`（完全复用）。排查「指标怎么变了」时先看它

data.cvMetrics 各字段：

字段	类型	说明
auc	Number	ROC AUC
prAuc	Number	PR AUC
recallAtThreshold	Number	选定阈值下的 recall
precisionAtThreshold	Number	选定阈值下的 precision
fbeta	Number	F-beta 值

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例-任务完成状态成功示例-任务处理中状态成功示例-任务失败状态失败示例-查询不存在的taskId

{
    "status": "COMPLETED",
    "data": {
        "taskId": "task-20260821-abc123",
        "status": "COMPLETED",
        "taskTraceId": "trace-x7k9m2n4p8q",
        "error": null,
        "clientId": "tenant-888",
        "modelVersion": "v2.3.1-20260821",
        "threshold": 0.732,
        "cvMetrics": {
            "auc": 0.894,
            "prAuc": 0.876,
            "recallAtThreshold": 0.812,
            "precisionAtThreshold": 0.765,
            "fbeta": 0.788
        },
        "nPos": 1523,
        "nNeg": 8477,
        "nRows": 10000,
        "nTrees": 127,
        "elapsedSeconds": 43.57,
        "datasetId": "sha256:3f7c9a2b1e4d8f0c6a5b3e7d9f1c8a2b4e6d7f0c9a5b3e7d1f8c2a4b6e0d8f",
        "sampleReuse": "full"
    }
}

一、接口描述#

输入参数#

输出参数#

请求参数

请求示例代码

返回响应

一、接口描述

输入参数

输出参数